Voice best practices
These tips come from real test calls on a demo-booking agent. They apply to any voice agent, on the website widget or a phone number. Each section has a snippet you can paste into your system prompt and adjust.
Capture emails and phone numbers
Speech recognition often mishears email addresses and long numbers, especially names, brand words and accented speech. Read them back once and let the caller fix them.
Emails
- Repeat the email back once, spelling it briefly.
- If the caller corrects it, don't guess again. Ask them to spell the part before the "@" letter by letter.
- Don't spell common providers such as gmail, outlook, yahoo, hotmail or icloud. Say them as words.
- Ask the caller to spell brand or company words, such as a company domain.
Phone numbers
- Read the number back once, digit by digit, in small groups, for example "nine eight seven, six five four, three two one zero".
- Never merge digits into bigger numbers. Say "nine eight", not "ninety-eight".
Collecting contact details:
- Email: repeat it back once, spelling it briefly, for example
"j-o-h-n dot smith at gmail dot com". Say common providers (gmail,
outlook, yahoo, hotmail, icloud) as words, don't spell them.
- If the caller corrects the email, do not guess again. Ask them to spell
the part before the "@" letter by letter, then read it back.
- If the email has a company or brand name in it, ask the caller to spell it.
- Phone numbers: read the number back once, digit by digit, in groups of
two to four digits. Never merge digits: say "nine eight", not "ninety-eight".
- Once the caller confirms, don't read the email or number back again.
Dates, times and time zones
Callers say "4 pm India time" or "tomorrow morning, I'm in Dubai". They rarely know time zone names, so let the agent work out the zone.
- Infer the time zone from what the caller says: a city, country or "X time".
- Never ask the caller for a time zone name.
- Only if the caller has said nothing about where they are, ask "Which city or country are you in?"
Dates, times and time zones:
- Work out the caller's time zone from what they say. Use IANA time zone
names in tools, for example:
"India time", India, Mumbai, Delhi -> Asia/Kolkata
Dubai, Abu Dhabi, UAE -> Asia/Dubai
Riyadh, Saudi Arabia -> Asia/Riyadh
UK, London -> Europe/London
Germany, Berlin -> Europe/Berlin
New York, "Eastern time" -> America/New_York
California, "Pacific time" -> America/Los_Angeles
Singapore -> Asia/Singapore
- Never ask the caller for a time zone name.
- Only if the caller hasn't mentioned a place, ask "Which city or country
are you in?"
- Say times the way people speak, for example "4 pm on Tuesday the 14th".
Keep turns short
Long replies are hard to follow on a call, and callers interrupt them.
- Keep each reply to one or two short sentences.
- Ask one thing at a time.
- Ask optional questions, such as "What's your use case?", once. Accept any answer, including "not sure", and move on.
- Confirm everything in one sentence at the end.
- When the caller says "yes", "go ahead" or similar, act on it. Don't read the details back again.
Conversation style:
- Keep each reply to one or two short sentences. Ask one question at a time.
- Ask optional questions once and accept any answer, including "not sure".
- Before booking, confirm all the details in one sentence, for example
"So that's a demo on Tuesday at 4 pm India time for john@acme.com,
shall I book it?"
- When the caller says yes, go ahead or similar, book straight away.
Don't repeat the details.
Say something before a slow action
Booking a meeting or looking up an order can take a few seconds. Silence on a call sounds like a dropped line, so have the agent say one short line before it starts.
Before you use a tool that may take a few seconds, say one short line
first, for example "Booking that now…" or "Let me check that…".
Don't say more than that while you wait.
Accents and mixed languages
Many callers speak English with an accent and mix in words from other languages, such as "haan", "theek hai", "inshallah" or "shukriya". A single word is not a request to change language.
- Reply in the language the caller's whole sentences are in.
- Don't switch because of one word, a name or a greeting.
- When unsure, use the agent's main language.
Language:
- Callers may speak with an accent and mix in words from other languages.
Reply in the language their whole sentences are in.
- Don't switch language because of a single word, a name or a greeting.
- If you're not sure which language the caller is using, reply in English.
Replace "English" with your agent's main language.
The agent's Language section, in Overview, decides the language the agent starts in and whether it follows the caller into another language. That setting overrides language rules in the prompt, so keep the two consistent. See Language.
Tool settings
Each tool connected to an agent has its own settings. Open the agent, go to Tools, and choose Settings on the tool.
| Setting | What it does | Use it for |
|---|---|---|
| Ask the caller to confirm before running | The agent reads the details back and must hear an explicit yes before the tool runs. | Bookings, payments, sending messages. Anything the caller would want to check first. |
| Show progress to visitors | Website visitors see a small status in the conversation while the tool runs. On by default. | Tools that take a few seconds and that a visitor would notice. |
| Progress message | The text of that status, up to 120 characters. The default is "Working on it…". | A short message that says what is happening, such as "Booking your demo…". |
| Run in the background | The agent doesn't wait for the tool. The tool's result isn't available to the agent, and no progress is shown. | Internal steps such as logging and notifications. |
Don't run a tool in the background if the agent needs its result, for example a calendar lookup or an order search. The agent carries on without it.
Example: a demo-booking agent
| Tool | Confirm first | Show progress | Progress message | Background |
|---|---|---|---|---|
| Calendar: book a meeting | On | On | Booking your demo… | Off |
| Sheet: log the lead | Off | Off | On | |
| Email: notify the sales team | Off | Off | On |
Test with real voices
- Test with real people, real accents and a real microphone. Typed messages and synthetic speech hide most speech-recognition problems.
- Try the hard cases: spell an email, correct a wrong one, give a phone number, mention a city instead of a time zone, and mix in a word from another language.
- Listen to call recordings and read transcripts in Observe → Calls & transcripts. See Conversation data.
- Use the Playground to try changes before you put them on a live channel.