Hands off a SIP call to an external endpoint and removes Daily from the media path.
sipRefer(options) Prebuilt CustomSends a SIP REFER to instruct the original SIP caller to establish a direct connection with a new destination. Once the REFER succeeds, Daily exits the media path entirely and stops billing for that leg.Use this instead of sipCallTransfer() when Daily should not remain in the call path after the transfer. If Daily should stay anchored in the call, use sipCallTransfer().sipRefer() works with both SIP providers. It is the only transfer method for a session on the Daily SIP provider.Requires the initiating participant to be an owner or admin.
Each call to sipRefer() is billed separately. A one-time SIP REFER fee may apply when this method is called. Contact support for pricing details.
Parameters
string
required
The session_id of the SIP participant to transfer.
string
required
The destination SIP URI (e.g., sip:support@sip.example.com) to refer the caller to.
Return value
Returns a Promise<void>.When the REFER is triggered, participant-left, dialin-stopped, and dialout-stopped events fire in the originating room. For a session on SignalWire, the default provider, calltransfer webhooks (triggered, initiated, answered, complete) are also emitted.