Skip to main content
A waiting participant left event is sent when a knocking participant (see blog post) leaves the knocking state. In other words, when a knocker begins to knock and leaves before being allowed into a room, a waiting-participant.left event is sent. If a knocker is allowed into a room and then leaves, a participant.left event is sent.

​
Common fields

​
version
string
Represents the version of the event. Uses semantic versioning to inform a consumer if the payload has introduced any breaking changes.
​
type
string
Represents the type of the event described in the payload.
​
id
string
An identifier representing this specific event.
​
payload
object
An object representing the event, whose fields are described below.
​
event_ts
number
Documenting when the webhook itself was sent. This timestamp is different than the time of the event the webhook describes.

​
Payload

​
joined_at
number
The Unix epoch time in seconds representing when the waiting participant joined.
​
duration
number
The time in seconds representing how long the participant was in the call.
​
session_id
string
The user session ID, or participant id.
​
room
string
The name of the room.
​
user_id
string
The ID of the user, set by the meeting token.
​
user_name
string
The name of the user, set by the meeting token.
​
owner
boolean
A flag determining if this user is considered the owner.
​
networkQualityState
string
The quality of the user’s network.
​
will_eject_at
integer
The Unix epoch time in seconds representing when the participant will be ejected.
​
permissions
object
The permissions object, that describes what the participant is permitted to do during this call.
{
  "version": "1.0.0",
  "type": "waiting-participant.left",
  "id": "1-w-ptcpt-left-c85f48f3-82ec-4648-b39c-edfce7acf062",
  "payload": {
    "room": "knocking",
    "user_name": "bipol",
    "session_id": "c85f48f3-82ec-4648-b39c-edfce7acf062",
    "joined_at": 1719586614.027,
    "will_eject_at": null,
    "owner": false,
    "permissions": {
      "hasPresence": true,
      "canSend": true,
      "canReceive": { "base": true },
      "canAdmin": false
    },
    "duration": 14.403000116348267
  },
  "event_ts": 1719586628.431
}