Skip to main content

​
app-message

Prebuilt Custom Fires when a participant broadcasts a message via sendAppMessage(). Messages are not stored and not delivered to the sender. Participants who join after a message is sent will not receive it.
​
action
string
Always "app-message".
​
callClientId
string
The ID of the call client instance that emitted this event.
​
data
any
The message payload. Must be JSON-serializable.
​
fromId
string
The session_id of the participant who sent the message.
// Example event object
{
  "action": "app-message",
  "callClientId": "15943200481050.884650320964697",
  "data": {
    "message": "Your message here!"
  },
  "fromId": "fc30e773-c71f-4eea-a456-4e7e2449a68a"
}

call.on('app-message', ({ data, fromId }) => {
  displayChatMessage(fromId, data.message);
});

​
meeting-session-state-updated

Prebuilt Custom Fires when anything in meetingSessionState() changes — including data set via setMeetingSessionData() and session metadata like network topology.
​
action
string
Always "meeting-session-state-updated".
​
callClientId
string
The ID of the call client instance that emitted this event.
​
meetingSessionState
DailyMeetingSessionState
The current meeting session state. Contains data (the shared data payload, type unknown) and topology (the current network topology: 'sfu', 'peer', or 'none').
// Example event object
{
  "action": "meeting-session-state-updated",
  "callClientId": "17225364729060.9442072768918943",
  "meetingSessionState": {
    "data": {},
    "topology": "sfu"
  }
}

​
meeting-session-summary-updated

Prebuilt Custom Fires when the meeting session summary changes. Prefer this over the deprecated meeting-session-updated event.
​
action
string
Always "meeting-session-summary-updated".
​
callClientId
string
The ID of the call client instance that emitted this event.
​
meetingSession
DailyMeetingSessionSummary
The current meeting session summary. Contains an id string.
// Example event object
{
  "action": "meeting-session-summary-updated",
  "callClientId": "17225364729060.9442072768918943",
  "meetingSession": {
    "id": "meeting-session-abc123"
  }
}

​
meeting-session-updated

Prebuilt Custom
meeting-session-updated is deprecated. Use meeting-session-summary-updated instead.
Fires when the meeting session changes — for example, when you’ve been alone in a room long enough that a new session begins.
​
action
string
Always "meeting-session-updated".
​
callClientId
string
The ID of the call client instance that emitted this event.
​
meetingSession
DailyMeetingSession
deprecated
Deprecated. The meeting session object. Contains an id string.
// Example event object
{
  "action": "meeting-session-updated",
  "callClientId": "17225364729060.9442072768918943",
  "meetingSession": {
    "id": "meeting-session-abc123"
  }
}

​
See also

Methods

Guides