This page covers transferring from your agent code. For the underlying SIP REFER mechanism and provider requirements, see Call Transfer in the Telephony platform docs.
How Call Transfer Works
The agent evaluates the user’s intent to determine when a call transfer is required and then triggers the function tool. When the function tool is triggered, it tells the system to move the call to another phone number. The ongoing SIP call is forwarded to the new number instantly, without disconnecting or redialing.Setup
Expose a function tool on your agent that callssession.call_transfer (Python), session.callTransfer (JavaScript), or the session’s CallTransfer method (Go) with your auth token and the destination number. The agent invokes the tool when it detects the user wants to be transferred.
See Handoff vs Transfer for the difference between Call Transfer and Agent Handoff.
What’s Next
Voicemail Detection
Detect voicemail systems on outbound calls.
DTMF Events
Capture caller key presses.