Documentation ›Your AI agent

Agent Personality

How the agent is briefed

You describe your business: services and prices, opening hours, addresses, how to book. How the agent talks — keeping voice answers to a sentence or two, never inventing a price or a confirmation, asking again instead of guessing, handing over to a person in time — is built in and kept up to date by us. It is the same for every account, and it is not edited or shown.

An account created before this may still run on a prompt it wrote in full. It can keep editing that prompt, or move over with Describe my business instead: write the description, save, and the agent switches. The move is one way — from then on the built-in behaviour stays, and the old prompt is kept but no longer used.

Start from a template

Above the description you will find a row of business types — dental clinic, beauty, lab and diagnostics, real estate, auto service, school, or any service business. Click one and the box fills with the headings the agent needs, in the order that works best: who you are, services and prices, opening hours, addresses, how to book, when to hand over to a person, frequent questions, and what must never be said.

Replace the text in square brackets with your own. You do not have to keep every heading — delete what does not apply. If you have already written something, we ask before replacing it.

The last heading is optional and matters in some countries: if the law requires you to tell people they are talking to a machine, write that instruction there in your own words.

Fill in from your website

Under About your business, paste your website address and click Read the site. We read the page and draft the description for you. It is only a draft — read it, fix anything wrong, and click Save. Nothing reaches your agent until you save.

A draft is only as good as the page: if prices or hours aren't written on your site, they won't appear — add them by hand.

System Prompt

Instructions that define who the agent is and how it should behave. This is invisible to customers but shapes every response.

There is a length limit, and going over it is refused rather than trimmed: the prompt is not saved, your previous one stays in place, and the banner shows how far over you are. Your plan may set a lower limit than the maximum — the same one the API reports under limits. Nothing is ever cut silently, because the end of a prompt is usually where its most important rules live.

When one answer is not enough. Separate from the prompt, in Settings. Not a "be shorter" dial — most answers are already the right length; the damage is the occasional one that runs long. Choose what the agent does when a proper answer will not fit in two sentences: deliver it in full (what every agent does today), say the key part and offer to continue, or say the key part and offer a colleague. It applies on calls and in chats, and it needs no edit to your prompt. On a phone line the difference is large: past about fifteen seconds people stop listening and start interrupting.

Let it watch first. A switch in Settings. In WhatsApp, Telegram and Instagram the agent answers nobody: messages still reach your dashboard, your CRM and your operator group exactly as they do now, and your team replies as usual. Calls and the chat on your website are still answered by the agent. Use it for the first days, while you fill in the agent's knowledge and test it yourself (see Testing Your Agent), before it answers your customers in chats. Turn it off when you are ready.

Your customers' language. In Settings, under «How the agent answers». By default the agent works in the language your business description is written in. If your customers speak another one — a clinic in Dubai described in Russian, a practice in New York described in Chinese — choose their main language there, and up to three more if they switch between them. The agent then listens for those languages on calls, and the platform's own phrases (a fallback reply, «an operator has joined») follow the main one; those phrases exist in Russian, English and Spanish, and are in English for any other language. Replies still follow whatever language each customer speaks. Notifications to your team keep their own language setting.

Include:

  • Agent name and role
  • Company name
  • Language to respond in
  • Tone (formal, friendly, professional)
  • What NOT to do (don't make up prices, don't promise delivery dates)

How to write the business block for a phone line

The platform supplies the behaviour — how long an answer may be, never inventing a price, asking again instead of guessing, when to hand over to a person. It is maintained by us and improves for every account. Your part is the facts, and how they should sound out loud.

Write facts, not style. Services and prices, opening hours, addresses, how to book, what is free and on what condition, who to hand a call to. Do not re-write rules like "answer briefly" or "be polite" — they are already in force, and a stale copy of yours would override a rule we later improve.

Anything a person has to say out loud, write out in words. An abbreviation, a method, a product name: put the spoken form right next to the written one and the agent says it verbatim instead of recomputing it — "SPF — say S-P-F". Hours, addresses, phone numbers and prices are the exception: they go in "Say these word for word" below, not here. Written twice they drift apart, and the agent has been heard reading the label itself out loud to a customer.

Name things the way your customer names them. Internal codes, method names and catalogue titles help the agent RECOGNISE what was asked, so keep them — but add the everyday name, and the agent will speak that one.

Long price lists belong in the Knowledge Base, not the prompt — split into small documents by section. Keep in the prompt only what is needed on most calls.

Outbound calls reuse this same block as the reference, plus a short overlay for what changes when we are the ones calling. You do not need a second copy of your facts.

Voice and tempo. In Settings → Voice pick marin or cedar — the newest voices, the most natural pronunciation and accent ; the older ones stay for accounts that chose them. Speech tempo is a multiplier of the natural speed: 1.1–1.2 if the agent sounds like it is stretching words on the phone, 0.9 if callers ask it to slow down. Blank = natural. Pronunciation of terms is set in the prompt, not here: write the spoken form once ("SPF — say S-P-F") and the agent uses it.

The agent tells you what it did not know. Under that field there is a link: «What are people asking that the agent cannot answer?». It reads the last month of tasks that came out of calls, names the fact each one was missing, and shows the ones that came up more than once — «×7 price of a consultation — Downtown». Click «Add a line» and the place and the question are written into the field with the answer left blank, for you to fill in. It never guesses the answer: we know what people asked, only you know your prices, and a confident invented number read out to a customer is the one mistake we will not risk. An unfinished line is simply ignored until you complete it.

Next to a question you also see how many of those customers are still waiting for a callback. Finish the line and save: from then on the agent says the answer itself, and each of those open «call back» tasks gets the answer added to its notes, word for word — whoever calls them back has it in hand. Nobody is called or messaged automatically. Once a week the top questions also appear on the home page under «The agent did not know», with a link straight to this list.

"Say these word for word" (Settings → Agent, under your business description). Hours, addresses, phone numbers and your headline prices are what a customer writes down and acts on, and they have one correct wording. List them here — one per line, place | what it is | exactly what to say — and the agent speaks the line as written instead of rebuilding it: no recalculated times, no digits turned into its own numbers, no two branches on the same street mixed up. Write the numbers the way they should sound out loud ("one hundred and eleven", not "111"). Prices go in the same way — one line per price, named the way people ask for it ("consultation price", "cleaning price", "callout price"); when a caller's wording matches nothing exactly, the agent is told which lines exist and picks the right one rather than inventing a figure. Leave it empty and nothing changes: the agent answers from your description as before.

A second language. Add the language in brackets after what the line is — Downtown | hours (es) | … — and a caller who speaks that language hears your own wording instead of a translation made on the spot. Write the same fact twice, once per language; whichever is missing falls back to the line without a mark, so nothing breaks while you are still filling it in. The agent's own short lines — asking a caller to repeat, handing a bad line to a person — follow the caller's language as well (Russian, English, Spanish, Kazakh).

Answers that are the same everywhere. Write All | what it is | … for a short answer that does not depend on the branch — how customers get their documents, how to prepare, what is free — and the agent says your line instead of explaining it in its own words each time. No city is asked for these; a branch that has its own line for the same thing keeps it. Keep each line to one or two short sentences: it is spoken on the phone.

Several branches in one city. Put all their addresses on one line, one sentence per branch — Downtown | address | Main Street, twenty-two. There is another one — Park Avenue, six. A customer who has not chosen yet hears both; one who already named a street hears only that branch, instead of both addresses read again.

Hours that differ by day. Write one sentence per group of days — Main | hours | Monday through Friday, eight to five. Saturday, nine to one. Closed Sunday. A customer who asks about one day — "are you open tomorrow?", "on Saturday?" — hears that day's sentence, worked out on your own time zone, not the whole week.

Noise, unclear speech and interruptions are handled on every phone line — there is nothing to switch on. The agent says nothing to background talk; it asks the caller to repeat unclear speech instead of answering a question nobody asked; a short reply it could not write down is not treated as noise; a loud sound pauses the answer and the transcript decides — real words cut it short, a child or a TV lets it continue where it paused. A request for a person that the agent missed is carried out by the platform itself within two turns.

Welcome Message

The first thing the agent says on a call — and now the first thing it writes in a chat, so a customer on WhatsApp, Telegram or Instagram is greeted the same way a caller is. Write it in every language you serve: the greeting is where a customer learns which languages they may use with you. Leave empty and the agent waits for the customer on a call and opens straight into the answer in a chat.

Voice

The voice used for phone calls and voice demos.

marin, cedar — recommended: the most natural on the phone

alloy, ash, ballad, coral, echo, sage, shimmer, verse — other voices to try

Max Response Tokens

A hard cut-off, not a target. If a reply runs past this limit it is cut off mid-word — the customer hears the sentence stop dead. Keep it generous: how long an answer should be is handled by the platform.

1024: Recommended. Leaves room for a normal reply.

Shorter answers are not made by lowering this limit — it only cuts a reply off mid-word.

Text-only blocks in the prompt

One prompt serves calls and chats, but photo rules or "you may answer in several lines" only make sense in a chat. Wrap such parts in [[ТОЛЬКО-ТЕКСТ]] … [[/ТОЛЬКО-ТЕКСТ]] (or [[TEXT-ONLY]] … [[/TEXT-ONLY]]): phone calls skip them, WhatsApp, Telegram, Instagram and the widget keep them. Every opening marker needs a closing one — an unbalanced pair leaves the prompt untouched.

The mirror image exists too: wrap parts that only make sense on a phone call — “say you couldn’t hear”, spoken forms of numbers, “read the label out loud” — in [[ТОЛЬКО-ГОЛОС]] … [[/ТОЛЬКО-ГОЛОС]] (or [[VOICE-ONLY]] … [[/VOICE-ONLY]]). Calls keep them, chats skip them. Your “Say these word for word” card already reaches chats on its own, written in digits, so hours and addresses need no copy.