sipCallTransfer()

Transfer a SIP dial-in call from one Daily room to another Daily room. Alternatively, transfer an initiated SIP/PSTN Dialout to another SIP URI or PSTN number. Note that the participant who initiates this must be an owner or an admin.

Example Scenarios

SIP Dialin call transfer

  • user dials in to room-a's SIP URI (originating SIP device).
  • sipCallTransfer() API is called with sip_uri endpoint of Daily room-b.
  • Originating SIP device disconnects from room-a and joins room-b.
  • a participant-joined for the originating SIP device is received on room-b, while a dialin-stopped is recieved on room-a.

SIP Dialout call transfer

  • room-a dials out to a SIP device sip:someone@sip.abc.com.
  • sipCallTransfer() API is called with sip url sip:someother@sip.xyz.com.
  • sip:someone@sip.abc.com disconnects from room-a, sip:someother@sip.xyz.com starts ringing.

(This could also be done by disconnecting the first SIP dialout and initiating a new SIP dialout).

PSTN Dialout call transfer

  • room-a dial out to phone number +12345678900
  • sipCallTransfer() API is called with phone number +18765932534
  • phone +12345678900 disconnects from room-a, +187659325346 starts ringing

(This could also be done by disconnecting the first PSTN dialout and initiating a new PSTN dialout).

sipCallTransfer(params)

Parameters

  • sessionId the sessionId of the sip/pstn participant that we want to transfer.
  • toEndPoint destination sip/pstn address to where the call is transferred.
Compatibility:
Prebuilt
Custom