Telephony events (SIP/PSTN)

These events fire during SIP/PSTN telephony sessions started with startDialOut() or triggered by inbound SIP dial-in. See the dial-in/dial-out guide for setup.

Dial-in Events

dialin-ready

Fires when the SIP worker is ready to receive a call. Only emitted when the room has SIP dial-in configured.

string

Always "dialin-ready".

string

The ID of the call client instance that emitted this event.

string

The SIP endpoint URI ready to receive calls (e.g. "sip:room-name@sip.daily.co").

string

The SIP/PSTN provider.

// Example event object
{
  "action": "dialin-ready",
  "callClientId": "17225364729060.9442072768918943",
  "sipEndpoint": "sip:room-name@sip.daily.co",
  "provider": "daily"
}

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.

string

Always "dialin-connected".

string

The ID of the call client instance that emitted this event.

string

Session ID of the dial-in participant.

string

The SIP Call-ID header value.

string

The SIP/PSTN provider.

string

Optional user ID associated with the session.

string

Optional SIP From address of the caller.

string

Optional SIP endpoint that received the call.

object

Optional SIP headers from the incoming request.

string

Optional trace ID for debugging.

// Example event object
{
  "action": "dialin-connected",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
  "userId": "user_123",
  "sipFrom": "sip:caller@example.com",
  "sipEndpoint": "sip:room-name@sip.daily.co",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

dialin-stopped

Fires when a SIP or PSTN session ends — either the remote end disconnected or the call was terminated.

string

Always "dialin-stopped".

string

The ID of the call client instance that emitted this event.

string

Session ID of the participant whose session ended.

string

The SIP/PSTN provider.

string

Optional user ID associated with the session.

string

Optional SIP From address of the caller.

string

Optional SIP endpoint that received the call.

object

Optional SIP headers.

string

Optional SIP Call-ID.

string

Optional trace ID for debugging.

// Example event object
{
  "action": "dialin-stopped",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

dialin-error

Fires when a fatal error occurs in the dial-in pipeline — for example, an SDP negotiation failure.

string

Always "dialin-error".

string

The ID of the call client instance that emitted this event.

string

Human-readable error description.

string

Session ID of the affected participant.

string

The SIP/PSTN provider.

string

Optional error classification. Currently only 'start-failed'.

string

Optional user ID.

string

Optional SIP Call-ID.

object

Optional details object. May contain sipEndpoint.

string

Optional trace ID for debugging.

// Example event object
{
  "action": "dialin-error",
  "callClientId": "17225364729060.9442072768918943",
  "errorMsg": "SDP negotiation failed",
  "sessionId": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
  "type": "start-failed",
  "provider": "daily"
}

dialin-warning

Fires for non-fatal dial-in errors, such as when a requested codec is unavailable and a fallback is applied.

string

Always "dialin-warning".

string

The ID of the call client instance that emitted this event.

string

Human-readable description of the warning.

string

Session ID of the affected participant.

string

The SIP/PSTN provider.

// Example event object
{
  "action": "dialin-warning",
  "callClientId": "17225364729060.9442072768918943",
  "errorMsg": "Requested codec unavailable, using fallback",
  "sessionId": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
  "provider": "daily"
}

Dial-out Events

dialout-connected

Fires when the outbound call is established and ringing at the remote end.

string

Always "dialout-connected".

string

The ID of the call client instance that emitted this event.

string

Session ID of the dial-out participant.

string

The SIP Call-ID header value.

string

The SIP/PSTN provider.

string

Optional. Phone number in E.164 format or SIP URI of the remote party.

string

Optional. Originating address — phone number in E.164 or SIP URI.

string

Optional. Caller ID presented to the remote party.

string

Optional user ID associated with the session.

string

Optional trace ID for debugging.

{
  "action": "dialout-connected",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "destination": "+12098888888",
  "origin": "+13977888822",
  "callerId": "+13977888822",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

{
  "action": "dialout-connected",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "destination": "sip:callee@example.com",
  "origin": "sip:myroom.0@daily-2358023-app.dapp.signalwire.com",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

dialout-answered

Fires when the remote party answers the outbound call.

string

Always "dialout-answered".

string

The ID of the call client instance that emitted this event.

string

Session ID of the dial-out participant.

string

The SIP Call-ID header value.

string

The SIP/PSTN provider.

string

Optional. Phone number in E.164 format or SIP URI of the remote party.

string

Optional. Originating address.

string

Optional. Caller ID presented to the remote party.

{
  "action": "dialout-answered",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "destination": "+12098888888",
  "origin": "+13977888822",
  "callerId": "+13977888822",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

{
  "action": "dialout-answered",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "destination": "sip:callee@example.com",
  "origin": "sip:myroom.0@daily-2358023-app.dapp.signalwire.com",
  "sipCallId": "abc123@sip.daily.co",
  "provider": "daily"
}

dialout-stopped

Fires when the dial-out session ends — either the remote party hung up or stopDialOut() was called.

string

Always "dialout-stopped".

string

The ID of the call client instance that emitted this event.

string

Session ID of the dial-out participant.

string

The SIP/PSTN provider.

string

Optional. Destination phone number or SIP URI.

string

Optional. Originating address.

string

Optional SIP Call-ID.

// Example event object
{
  "action": "dialout-stopped",
  "callClientId": "17225364729060.9442072768918943",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "destination": "+12098888888",
  "origin": "+13977888822",
  "provider": "daily"
}

dialout-error

Fires when a fatal error occurs in the dial-out pipeline.

string

Always "dialout-error".

string

The ID of the call client instance that emitted this event.

string

Human-readable error description.

string

The SIP/PSTN provider.

string

Optional session ID.

string

Optional user ID.

string

Optional SIP Call-ID.

object

Optional details object. May contain destination.

string

Optional trace ID for debugging.

// Example event object
{
  "action": "dialout-error",
  "callClientId": "17225364729060.9442072768918943",
  "errorMsg": "DialOut failed with error: process error, Channel closed",
  "sessionId": "22b32b65-cd65-42b2-9665-db05ef3e1255",
  "details": { "destination": "+12098888888" },
  "provider": "daily"
}

dialout-warning

Fires for non-fatal dial-out errors, such as when a requested codec is unavailable and a fallback is applied.

string

Always "dialout-warning".

string

The ID of the call client instance that emitted this event.

string

Human-readable description of the warning.

string

The SIP/PSTN provider.

string

Optional session ID of the affected participant.

// Example event object
{
  "action": "dialout-warning",
  "callClientId": "17225364729060.9442072768918943",
  "errorMsg": "Requested codec unavailable, using fallback",
  "sessionId": "7d208e2a-520b-4a8d-a2c9-3a36dfa0d342",
  "provider": "daily"
}

Daily Call Client

Types

Static Methods

Instance Methods

Events

Telephony events (SIP/PSTN)

Dial-in Events

dialin-ready

dialin-connected

dialin-stopped

dialin-error

dialin-warning

Dial-out Events

dialout-connected

dialout-answered

dialout-stopped

dialout-error

dialout-warning

See also

Methods

Guides

​Dial-in Events

​dialin-ready

​dialin-connected

​dialin-stopped

​dialin-error

​dialin-warning

​Dial-out Events

​dialout-connected

​dialout-answered

​dialout-stopped

​dialout-error

​dialout-warning

​See also

Methods

Guides

Dial-in Events

dialin-ready

dialin-connected

dialin-stopped

dialin-error

dialin-warning

Dial-out Events

dialout-connected

dialout-answered

dialout-stopped

dialout-error

dialout-warning

See also