Meeting Participants & Metadata
Bot objects will contain meeting metadata and a list of participants after they've successfully joined a meeting.
Since the bot only has access to this data after joining the call, these fields will only be populated after the bot has become in_call_not_recording
.
These fields can be accessed on bot objects when calling Retrieve Bot and List Bots.
meeting_participants
meeting_participants
The
meeting_participants
list is available on a Bot object for all supported meeting platforms.
Participant Events
Each participant will have an events
array with various in-call events.
Event | Description |
---|---|
join | Participant has joined the call |
leave | Participant has left the call |
video_on | Participant has turned their video on |
video_off | Participant has turned their video off |
screen_on | Participant has started screensharing |
screen_off | Participant has stopped screensharing |
audio_on | Participant has unmuted themselves (native bots only) |
audio_off | Participant has muted themselves (native bots only) |
Below are examples of participant objects for each meeting platform.
Zoom
{
"id": 187298462,
"name": "John Doe",
"events": [
{
"code": "join",
"created_at": "2024-01-26T19:50:22.473707Z"
},
{
"code": "leave",
"created_at": "2024-01-26T19:51:18.904019Z"
}
],
"is_host": true,
"platform": "unknown",
// `extra_data` is null for Zoom Native
"extra_data": {
"zoom": {
"os": 2,
"guest": false,
"user_guid": "...",
"conf_user_id": "..."
}
} || null
}
Google Meet
{
"id": 100,
"name": "John Doe",
"events": [
{
"code": "join",
"created_at": "2024-01-26T19:50:22.473707Z"
},
{
"code": "leave",
"created_at": "2024-01-26T19:51:18.904019Z"
}
],
"is_host": true,
"platform": "unknown",
"extra_data": null
}
Microsoft Teams
{
"id": 100,
"name": "John Doe",
"events": [
{
"code": "join",
"created_at": "2024-01-22T19:51:39.095356Z"
},
{
"code": "leave",
"created_at": "2024-01-22T19:51:46.900889Z"
}
],
"is_host": true,
"platform": "unknown",
"extra_data": {
"microsoft_teams": {
"role": "admin", // "guest"
"user_id": "8:live:.cid...",
"tenant_id": "",
"meeting_role": "organizer",
"client_version": "SkypeSpaces/1415/1.0...",
"participant_type": "inTenant" // "anonymous", "nonFederated", "federated"
}
}
}
Slack Huddles
{
"id": 92094358,
"name": "John Doe",
"is_host": true,
"platform": "unknown",
"events": [
{
"code": "leave",
"created_at": "2024-04-01T20:59:54.532847Z"
},
{
"code": "join",
"created_at": "2024-04-01T20:01:41.061838Z"
}
],
"extra_data": {
"slack": {
"email": "[email protected]",
"user_id": "<SLACK_USER_ID>"
}
}
}
Webex
{
"id": 100,
"name": "John Doe",
"events": [
{
"code": "join",
"created_at": "2024-04-22T23:33:15.003949Z"
},
{
"code": "leave",
"created_at": "2024-04-22T23:33:42.006927Z"
}
],
"is_host": true,
"platform": "unknown",
"extra_data": null
}
meeting_metadata
meeting_metadata
Platform Support
Platform | Supported? |
---|---|
Zoom | ✅ |
Google Meet | ❌ |
Microsoft Teams | ❌ |
Cisco Webex | ❌ |
Slack Huddles | ✅ |
Zoom
{
"meeting_metadata": {
"title": "John Smith's Personal Meeting Room",
"zoom_meeting_uuid": "x7OAB2GkQmFZuNhAY+nTNg=="
},
},
...
}
Slack Huddles
{
"meeting_metadata": {
"huddle_id": "...",
"channel_id": "..."
},
},
...
}
FAQ
Can I get participant emails from the bot?
Meeting platforms don't expose participant emails for security reasons, so bots aren't able to capture participant emails just by being present in the call.
To map participants to their corresponding email addresses, you can use the Recall Calendar Integration, or implement a calendar integration of your own.
Updated 9 days ago