Skip to main content
Call Transfer lets your AI Agent move an ongoing SIP call to another phone number without ending the current session. Instead of making the caller hang up and redial, the agent routes the call automatically.
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 calls session.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.