A connected SIP call can be forwarded to a phone number or SIP destination by the agent’s Call forward step or system tool. The managed telephony service performs the transfer; you do not need a Socket.IO client to consume the call-forward trace.

Choose the transfer destination

Configure the destination in the Call forward step or Call forward system tool. Configure the connection’s Outbound calls and transfers settings for calls routed back through your phone system.

Transfer handling and context

Transfer result

Voiceflow waits for queued speech before requesting the transfer. After a successful transfer request, it stops the agent’s media stream without hanging up the bridged call. Acceptance of the request is not proof that a human answered.

If the provider rejects the SIP REFER or phone-transfer request, Voiceflow ends the agent call with CALL_FORWARD_FAILED. Check the PBX’s transfer policy and destination routing before testing again. Call forwarding is disabled for prototype outbound calls.

Pass transfer context

Append SIP headers after ?, separated by &. Percent-encode header values. Voiceflow separates these values from the URI before passing them to the provider. User-to-User receives dedicated UUI handling; other headers are passed as custom headers. A literal + stays a plus, rather than becoming a space.

Headers can carry customer context. Pass identifiers your phone system needs and ensure the receiving system interprets them; adding a header does not configure the receiving application.

Transfer example

Pass a ticket reference to a SIP destination

Add context headers to the destination configured in Call forward.
SIP transfer destination

The target URI is sip:support@example.com; the custom ticket header contains 1042, and the UUI header contains case=1042. This is an illustrative destination, not a callable endpoint.

Use SIP troubleshooting when a transfer ends the call. The custom-client handoff reference documents call-forward trace fields for integrations that own their telephony client.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.