Call Transfer
Call transfer lets your agent hand a live call to a real person on your team, for example when the caller asks for a human, raises a complaint, or needs help the agent can't give.
You can send every transfer to one number, or have the agent pick the right number for the situation (billing, sales, a specific branch, and so on).
Turn on call transfer
- Open your agent and go to the Call Settings tab.
- Switch on Call Transfer.
- Enter a Default Number. This is where the agent transfers callers unless your instructions say otherwise.
- Optional: enter an Emergency Number. The agent uses it instead of the default number when the caller describes an urgent or safety-critical situation.
- Save.
Then tell the agent when to transfer in your Agent Prompt:
"If the caller asks to speak to a manager or complains about a previous visit, transfer the call."
If you've turned on Call Transfer but haven't entered an Emergency Number, urgent calls go to the Default Number.
Transfer to different numbers by situation
To send different kinds of calls to different people, write each number into your Agent Prompt, next to when it should be used:
"If the caller has a billing or payment question, transfer to +91 98111 22233. If they want to buy a new plan, transfer to our sales team at +91 80 4567 8901. For anything else that needs a person, transfer the call."
During the call, the agent picks the matching number. If nothing in your instructions matches the situation, it uses the Default Number.
Things to know:
- Write the full number in the prompt. Including the country code (for example
+91 98111 22233) is safest. A 10-digit number without one is treated as an Indian number. Spaces, dashes and brackets are fine. - Only numbers you've written down are ever dialled. The agent can transfer only to your Default Number, your Emergency Number, or a number written in your instructions. If a caller asks to be transferred to some other number, the agent won't dial it. This stops callers from getting the agent to call numbers you haven't approved.
- Type the number out in full. A number that only appears in the prompt through a
variable, such as
{{contact_number}}, doesn't count, so the agent won't dial it. - Call Transfer must be switched on. Numbers in your instructions are ignored while Call Transfer is off on the Call Settings tab.
- Multi-Step Agents work the same way: a number written in any step's instructions can be used.
- Custom System Prompt: if you've edited the System Prompt, keep the
{{transfer_section}}token. It tells the agent how to use transfer numbers.
What the caller hears
- The agent confirms it's transferring them.
- It plays a short "please hold" message in the language the call is currently in.
- The caller hears a dial tone while your team's phone rings. The number rings for up to 30 seconds.
- When someone answers, the caller is connected and the agent goes quiet. It doesn't listen or speak for the rest of the call.
If the transfer doesn't go through
If the number is busy, nobody answers within 30 seconds, or the call can't be connected, the caller isn't dropped. The agent comes back, briefly tells the caller why (for example, "the line was busy"), and keeps helping them itself.
The agent tries a transfer at most twice per call. After two attempts that didn't connect, it stops trying and keeps handling the call itself.
If the caller hangs up while your team's phone is still ringing, the transfer is cancelled and the call ends, so your team member doesn't pick up to an empty line.
After the call is connected
- The call ends as soon as either side hangs up.
- A transferred call can last up to 60 minutes. Your agent's own maximum call duration no longer applies once the call is transferred.
- The call is recorded as usual. The transcript covers only the part of the call with the agent, not the conversation with your team.
- The call outcome is Transferred only when your team actually answered. A transfer that didn't connect isn't counted as transferred.
Troubleshooting
| Problem | What to check |
|---|---|
| The agent never offers to transfer | Call Transfer is on and a Default Number is saved. Your Agent Prompt says when to transfer. |
| The agent always uses the default number | The situation-specific numbers are written out in full in the Agent Prompt, next to clear instructions on when to use each one. |
| The agent says it can't connect the caller | The number is correct and can receive calls. Try calling it yourself. Busy or unanswered lines are reported to the caller. |
| Transfers stop working partway through a call | The agent stops after two attempts that didn't connect in one call. |
See also Agent Prompting for writing clear instructions about when to transfer.