Skip to main content
This builds an agent that answers your phone number. The worked example is a receptionist for an insurance and surety agency, but the shape applies to anything that answers calls. It greets the caller, works out why they are calling, takes their details, and either leaves a message or transfers them to a person.
The prompt below is an example, not a template you have to use. Change it freely.

1. Create the agent

Go to Agents, create a new agent, and name it. On the Basic Information tab, pick a Voice and a Language. The play button previews the voice.

2. Write the opening lines

Two fields set the tone before the conversation starts. Initial Message is what the agent says when it picks up. Keep it short and say who you are. Voicemail Message is what it leaves if it reaches an answering machine.
The initial message is the single highest-leverage field on the page. It decides whether the caller engages or hangs up, and it takes ten seconds to change.

3. Write the prompt

The Agent Prompt on the Basic Information tab is the agent’s instructions. You can start from the library instead of a blank box. The dropdown above the prompt lists saved prompts, and Generate Prompt writes one from a description. See Prompts. Or paste the example below and replace {company_name} with yours.
Click Save when you are done.

4. Let the agent transfer to a person

The example prompt promises a live transfer, so the agent needs the ability to do it. On Basic Information, under Choose Skills, click Call Routing and add one rule.
The phrase in the rule and the phrase in the prompt must match, and the match is case insensitive containment on whole words. A short phrase will fire in the middle of an unrelated sentence, so keep it long and deliberate.Call Routing explains the matching in full, including warm transfers.

5. Point a number at it

An inbound agent does nothing until a number rings it. Go to Numbers and either Buy new or Link existing. Set Inbound Agent to this agent. You can also do it from the agent side. The agent page shows an Inbound badge reading Assign numbers, which opens a Setup Inbound Calls dialog.

6. Test it

Click Test Agent on the agent page. Start Phone Call rings a real phone, and is the only way to test a transfer. Start Browser Call talks to you in the browser, which is faster for checking the prompt.
Transfers only work on phone calls. If you test routing in the browser it will not fire, and the agent is not at fault.
Before testing, fill in any context values the test dialog offers, such as a name. Those are the values the agent would receive on a real call, so personalisation only sounds right when they are set. Check that the agent opens the way you expect, collects what you need, answers in line with the prompt, and transfers on the phrase when you ask for a person. The call then appears under Calls, where you can read the transcript and see what happened.

7. Improve it from a real call

Once you have a call that went wrong, do not guess at the fix. Open the call, click Improve agent, describe what should have happened, and let it propose prompt changes you can review one by one. See Testing an agent.

Where to go next