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

📘

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.

EventDescription
joinParticipant has joined the call
leaveParticipant has left the call
video_onParticipant has turned their video on
video_offParticipant has turned their video off
screen_onParticipant has started screensharing
screen_offParticipant has stopped screensharing
audio_onParticipant has unmuted themselves (native bots only)
audio_offParticipant 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


Platform Support

PlatformSupported?
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.