Skip to main content
In advanced call flows, it’s common to switch the handling agent, transferring the conversation from one AI agent to another. Agent Transfer (also known as Agent Swap) enables you to modularize tasks and re-use specialized agents without relying on traditional phone-based transfers. Examples:
  • Transferring from a front-desk agent to an appointment-booking agent based on task
  • Transferring from an agent speaking one language to another agent handling a different language, based on user preference

​
Why Use Agent Transfer Instead of Call Transfer?

Agent TransferCall Transfer
LatencyNear-instantSlower — requires new phone call
ReliabilityNo telephony failuresPotential phone connection failures
ContextDestination agent has full conversation history — no handoff message neededNo context passed
Phone numbersOne number for all agentsReceiving agents need their own numbers

​
Transfer Settings Behavior

The following settings of the first agent persist throughout the entire call:
  • optInSignedUrl
  • optOutSensitiveDataStorage
  • webHookUrl
All other settings — such as language, voice, and voice model — reflect the currently active agent.

​
Setup

1

Add Agent Transfer Node

Select Agent Transfer from the Add New Node menu.
2

Configure Details

  • Transfer agent: The ID and version of the agent to transfer to. You can select the latest version.
  • Speak during execution: Whether the agent should say something while performing the transfer.
  • Post-call analysis setting: For post-call analysis, extract dynamic variables for the transferred agent only, or both agents.
3

Test and Debug

Test agent transfer in both web call and playground.