Skip to main content
This guide walks through a concrete example of an inbound agent:
  • The agent acts as a receptionist for an insurance & surety / bond agency.
  • It understands why the caller is calling, collects contact details, and either:
    • Takes a message for a callback, or
    • Transfers the caller to a live representative using Call Routing.
You can adapt the same steps and prompt structure to your own business.
This is an example configuration, not a required template.
Feel free to simplify or change it as you get comfortable with agents.

1. Create a new agent

  1. In the left sidebar, go to Agents.
  2. Click Create Agent.
  3. On the Basic Information tab:
    • Give the agent a clear Name, for example:
      After-Hours Insurance & Bond Receptionist.
    • Choose a Voice that fits your brand.
    • Leave other fields as default for now; we’ll fill them in next.
There is no separate “inbound agent” type.
An agent becomes inbound when you assign a phone number to it.

2. Set Initial and Voicemail messages

Still on the Basic Information tab, set:

Initial Message

Example:
Hi, thanks for calling . This is the virtual assistant. How can I help you today?
This is the first line the caller hears.

Voicemail Message

Example:
Hi, this is the virtual assistant from . Sorry we missed you. I’ll pass your details to the team so they can follow up as soon as possible.
You can adjust wording later; start simple so you can test quickly.

3. Paste the example prompt

In the Agent Prompt box, paste the following example prompt, then replace {company_name} with your real company name.
Save the agent after pasting and customizing the prompt. 4. Enable Call Routing for live transfers

4. Enable Call Routing for live transfers

Because this example prompt uses live transfers, enable and configure the Call Routing skill.
  1. On the Basic Information tab, under Choose Skills, click Call Routing.
  2. In the Configure Call Routing dialog, create at least one rule, for example:
    • When the: bot
    • says: Let me connect you to a live representative now.
    • Transfer to: Support
    • at: your support phone number (a valid US number)
  3. Use the exact same phrase in both:
    • The Call Routing rule, and
    • The Agent Prompt.
For more details on routing options and behavior, see
Call Routing (Skill).

5. Get a phone number

To make this agent available for inbound calls, you need a phone number. If you don’t have one yet:
  1. Go to Numbers in the left sidebar.
  2. Click New or Link Existing.
  3. Follow the steps to:
    • Buy a new number (if supported), or
    • Link an existing number from your telephony provider.
  4. When creating or editing the number, select this agent as the Inbound Agent.
For more details on buying and linking numbers, see the
Numbers Feature Guide.

6. Assign an existing number to the agent

If you already have numbers in your account, you can attach one to this agent:
  • Either:
    • From Numbers, edit a number and choose this agent as the Inbound Agent, or
    • From the right side of the agent page, click Setup Inbound Calls and select one of your available numbers for this agent.
Once at least one number points to this agent as the inbound agent, callers who dial that number will reach this agent.

7. Prepare Call Context for testing

On the right side of the agent page, you’ll see Call Context fields such as first_name, phone, email, or any custom fields you define. Before testing:
  • Fill in realistic test values (for example, your own name and contact details).
  • These values will be available to the agent during the call, so you can hear how personalization works if you reference them in the prompt or messages.

8. Test your inbound agent

Use Test Call Agent to hear how everything works together.
  1. On the right side of the agent page, click Test Call Agent.
  2. In the test dialog:
    • Choose a Caller Number you own (if your UI shows this field).
    • Enter your own mobile or test number as the Receiver Number.
    • Adjust any other options (such as voicemail detection) if needed.
  3. Start the test call.
On your phone, verify that:
  • The Initial Message sounds right.
  • The agent:
    • Asks what you need,
    • Collects your name, phone, and email,
    • Handles simple questions in line with the FAQ part of the prompt,
    • Offers to connect you to a live representative if you ask to talk to a human, and triggers Call Routing correctly using the phrase
      “Let me connect you to a live representative now.”
  • The call appears in Calls / Call History.
You can iterate on the Initial Message and the prompt until you’re happy with the behavior.

Where to go next