startDialOut() or triggered by inbound SIP dial-in. See the dial-in/dial-out guide for setup.
Dial-in Events
sipEndpoint and sipEndPointCurrent daily-js versions send the dial-in endpoint as sipEndpoint, the spelling in the TypeScript type definitions, and also under the old spelling sipEndPoint. sipEndPoint will be deprecated, so prefer sipEndpoint. Older versions send only sipEndPoint, so sipEndpoint is undefined there. This applies to dialin-ready, dialin-connected, dialin-stopped, dialin-warning, and details on dialin-error.To support both, read sipEndpoint and fall back to sipEndPoint:sipEndpoint, so read the fallback with a cast: (ev as { sipEndPoint?: string }).sipEndPoint. Drop the fallback once your app no longer runs on older versions.The value starts with sip:, for example sip:my-room.0@my-domain.sip-us.daily.co. The room’s sip_uri.endpoint is the same address without the sip: prefix. Webhooks are not affected: they always use sip_endpoint.dialin-ready
Fires once for each of the room’s SIP endpoints when it is ready to receive a call. Only emitted when the room has SIP dial-in configured.The SIP endpoint URI ready to receive calls (e.g.
"sip:room-name.0@your-domain.sip-us.daily.co"). Also sent as sipEndPoint, which will be deprecated, and the only key on older daily-js versions; see sipEndpoint and sipEndPoint.The SIP provider:
'signalwire' or 'daily'. See SIP providers.dialin-connected
Fires when a SIP or PSTN caller has connected to the Daily room and both endpoints are negotiating media.dialin-connected does not mean media has started flowing — it means the connection request was received and media negotiation is underway.The call ID of the call leg. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional SIP endpoint that received the call. Also sent as
sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.dialin-stopped
Fires when a SIP or PSTN session ends — either the remote end disconnected or the call was terminated.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional SIP endpoint that received the call. Also sent as
sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.The call ID of the call leg, if available. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.dialin-error
Fires when a fatal error occurs in the dial-in pipeline — for example, an SDP negotiation failure.Session ID of the affected participant. Absent when
type is 'start-failed', because no session was created.The SIP provider:
'signalwire' or 'daily'. See SIP providers.The call ID of the call leg, if available. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.Optional details object. May contain
sipEndpoint (also sent as sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint), plus sipStatusCode (number) and
sipReasonPhrase (string): the status code and reason phrase of the rejected SIP request
(for dial-in, the REGISTER). Present only when the failure was a SIP rejection. A 408 or 503 may be generated locally on a timeout or transport failure rather than sent by the far end.dialin-warning
Fires for non-fatal dial-in errors, such as when a requested codec is unavailable and a fallback is applied.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional SIP endpoint that received the call. Also sent as
sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.The call ID of the call leg, if available. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.Dial-out Events
dialout-connected
Fires when Daily’s SIP leg for the dial-out is connected. With SignalWire, that is Daily’s leg to SignalWire, so the callee may still be ringing; wait fordialout-answered. With the Daily SIP provider, it is the call to the callee itself, so it fires only once the callee answers.
The call ID of the call leg. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional. The
callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.Optional. The
callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.dialout-answered
Fires when the remote party answers the outbound call. With SignalWire, it fires when the carrier reports the call answered. With the Daily SIP provider, it fires right afterdialout-connected, because that event is only sent once the SIP INVITE is answered.
The call ID of the call leg. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional. The
callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.Optional. The
callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.dialout-stopped
Fires when the dial-out session ends — the remote party hung up, the callee never answered (busy, declined, unreachable), orstopDialOut() was called.
With the default "signalwire" provider an unanswered dial-out ends here, carrying the callee’s SIP status; with "daily" it fires dialout-error instead. See unanswered dial-outs by provider.
The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional. The
callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.Optional. The
callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.The call ID of the call leg, if available. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.Optional,
"signalwire" provider only. The SIP status code with which the callee ended the
call before answering, e.g. 486 (busy), 603 (declined), 404 (not found). Absent when the
callee answered and later hung up, when the session was stopped through the API, and after a
call transfer. Best-effort: it can also be absent for an unanswered call when SignalWire’s call
record is not available in time, so a missing code does not mean the callee answered.Optional. The standard reason phrase for
sipStatusCode (RFC 3261), e.g. "Busy Here". It is
derived from the code, not the phrase the callee sent. Present only with sipStatusCode.dialout-error
Fires when a fatal error occurs in the dial-out pipeline.The SIP provider:
'signalwire' or 'daily'. See SIP providers.The call ID of the call leg, if available. On the Daily SIP provider this is the SIP
Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.Optional details object. May contain
destination; sipStatusCode (number) and
sipReasonPhrase (string), the status code and reason phrase of the rejected SIP request
(INVITE, or REGISTER for providers that register before dialing), present only when the
failure was a SIP rejection (a 408 or 503 may be generated locally on a timeout or transport failure rather than sent by the far end); and sipHeaders, a map of the custom X- SIP headers returned
by the remote SIP endpoint when it rejected the dial-out, useful for debugging and error
interpretation.dialout-warning
Fires for non-fatal dial-out errors, such as when a requested codec is unavailable and a fallback is applied.The SIP provider:
'signalwire' or 'daily'. See SIP providers.Optional. The
callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.Optional. The
callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.DTMF events
dtmf-event
Fires when a SIP or PSTN participant presses a key, on dial-in and dial-out legs alike. Every participant in the room receives it. See receiving DTMF for which SIP legs can deliver tones. There is no webhook for received tones.How the tone arrived:
'telephone-event' (RTP telephone event, Daily SIP provider only) or 'sip-info'.The volume reported with the tone: the RFC 4733 volume for a telephone event, or the
Volume field of the SIP INFO body (10 when the body has none).