This page covers the SIP platform mechanism. To trigger a transfer from your agent code with a function tool, see Transferring Calls.
How Call Transfer Works
When a call transfer is triggered, the current call log is instructed to REFER the call to a new destination. Once the transfer is successful, the original session is immediately ended and the caller is connected directly to the new destination.Ensure that SIP REFER (call transfer) is enabled on your SIP provider’s side. For Twilio, specifically, you must enable the “Transfer to PSTN” option in your SIP trunk settings to allow call transfers to external numbers or SIP endpoints. If this setting is not enabled, call transfer requests may fail.
Triggering a Call Transfer via API
You can initiate a call transfer by making an API request with the following payload: Sample Request:callId: The unique identifier of the ongoing call you want to transfer.transferTo: The SIP URI or phone number to which the call should be transferred.
Example
Telephony Agents
If you’re looking to perform call transfer using your AI Agent, check out building telephony agents.