Overview
An agent can place a technically perfect call that is still a bad experience: flat, roomless audio, a mangled business name, and a script that reads like a press release. The person who picked up does not blame the model. They blame the business whose name is on the call. Two separate things decide how a call sounds, and both are easy to leave on the floor:- The settings you dispatch with. Noise handling, background ambience, and transcription hints are parameters on
POST /v1/calls. - The way the prompt is written. The voice model was trained on recordings of people actually talking, so text that reads like a transcript performs dramatically better than text that reads like writing.
Dispatch settings
Write the prompt like a transcript
Put these rules in the prompt, and write the prompt’s own example lines this way too. A prompt written in polished prose teaches the agent to speak in polished prose. Say it plainly in the prompt: ums, uhs, and false starts are wanted. They are not sloppiness. They are what makes a voice sound like a person thinking instead of a machine reading copy, and a call with none of them is the one people hang up on. Write them in deliberately. In practice the failure is always too few, never too many, because a model left to its own judgment defaults to clean written prose and drops every one of them.- Contractions, always. “I’m”, “don’t”, “it’s”.
- Fillers where they genuinely land. “um”, “uh”, “you know”, “I mean”. Sparingly, at a rate a real person would actually use.
- False starts and self-corrections. “I just- I don’t even know what to say.” “the thing with the 25th is… well, actually, depends which one you’re going to.”
- Trailing off. “and I just… yeah.”
- Emphasis the way a transcript captures it. CAPS on the punched word (“that is NOT what happened”), a repeated word for real emphasis (“no, no, no, listen”), a stretched beat used rarely (“wait… what?”).
- Spoken rhythm. Short clauses. Fragments. Real interruptions. Not long literary sentences.
- Cut the written-English tells. No semicolons, no nested subclauses, and no words nobody says out loud (“moreover”, “utilize”, “delve”, “additionally”).
A block you can paste
Put this in yourtask or personality_prompt, then write the rest of the prompt’s own lines the same way. Avoid watering it down to “be conversational”, which is the instruction every robotic call was already given:
Tone on the phone
The goal is to convey what needs conveying in as few words as possible, the way people actually speak on a phone call.- Fewest words that still land. Ask what the most accurate reply is, then reduce it until reducing further would be rude.
- No recontextualizing. Cut “just to confirm”, “as you mentioned”, “so what I’m hearing is”. Assume the person remembers what they just said.
- Back-channel while they talk. “mhmm”, “uh huh”, “right”. Lead with one, or drop one in when the person pauses mid-thought.
- Empathy in stride. When someone says something heavy, react before continuing. Never “Got it, and your first name?” straight after bad news.
- Ultra-concise when collecting information. “Yup and last?” beats “Thank you, could I please have your last name as well?”
- Topic transitions can be slightly more formal. “awesome, thanks. And how can I help you today?”
- Personality sparingly. A light joke is fine when it does not interrupt the flow.
Performance tags
Bracketed tags shift delivery. A tag colors the words from its position until the next tag or the end of the line:[say sarcastically] or [sound amused] are ignored or garbled, so convey sarcasm through wording instead.
- Emotion
- Intensity
- Vocalizations
[say angrily] [say angrily with force] [say warmly] [say excitedly] [say quietly] [say in a whisper] [say nervously] [say sadly] [say wearily] [say playfully] [say confidently] [say loudly]- Two per line at most. Tags are seasoning. A prompt stuffed with them sounds theatrical, which is its own bad call.
- Tags amplify what the words already license.
[say angrily] You went behind my back?!lands hard. An angry tag on flat words barely moves. To change a line’s emotion, change the wording and the tag together. - Never invent tag syntax, and never nest tags.
- On a live call the agent’s replies are generated turn by turn, so tags belong in the prompt as instructions and examples of how to speak, not as a script you expect back word for word.
Before you dial
- Dispatching through
POST /v1/callsif the call needs anything beyond a number, a task, and a voice. noise_cancellationset explicitly.background_trackchosen deliberately.- Every proper noun in
keywords. - The prompt reads like a transcript, not like copy.
Next steps
Call recipes for agents
Voicemail, proper nouns, and escalating to a human.
Send Call API reference
Every parameter on this page, in full.
Agent quickstart
Place a call, learn how it ended, read the transcript.
Conversational Pathways
Structured flows when a prompt stops being enough.
Docs for agents: llms.txt