Webhook participant left or join does not provide the customerKey field

Feature Requests
1

Description
We use webhooks to identify when a participant joined or left a meeting.
Our participants join the meeting via the Meeting Web SDK (version 1.9.9).
Normal participants will be registered for a meeting and on join we provide the “tk” and a “customerKey” field.
A host is not registered and therefore the “tk” field is empty.
But we provide the “customerKey” field.
In the participant reports “{{baseUrl}}/report/meetings/:meetingId/participants” this “customerKey” is provided in the field “customer_key”. So we can idenditfy the participant.
In the participant webhooks this field is not provided.

Error
Please provide the “customerKey” also in the participant webhooks to have a chance to identify the host.
For registered participants the email and registrantId is provided.
For a host nothing is provided for identification.

Which App Type (OAuth / Chatbot / JWT / Webhook)?
Webhooks:

  • Participant joined
  • meeting.participant_joined
  • Participant left
  • meeting.participant_left

Additional context
Here some examples what we can fetch from reports and what webhooks send.

Participant report data example:
{{baseUrl}}/report/meetings/:meetingId/participants?page_size=30
Meeting ID: 93283599276

{
    "page_count": 1,
    "page_size": 30,
    "total_records": 2,
    "next_page_token": "",
    "participants": [
        {
            "id": "Tj8VWSXXXXX",
            "user_id": "XXXXX",
            "name": "Test User 1 (host)",
            "user_email": "",
            "join_time": "2021-10-15T08:53:27Z",
            "leave_time": "2021-10-15T08:54:17Z",
            "duration": 50,
            "attentiveness_score": "",
            "failover": false,
            "customer_key": "12345678"
        },
        {
            "id": "jNYB7RxRXXXXX",
            "user_id": "XXXXXX",
            "name": "Test User 2",
            "user_email": "testemail@ourdomain.com",
            "join_time": "2021-10-15T08:53:49Z",
            "leave_time": "2021-10-15T08:54:11Z",
            "duration": 22,
            "attentiveness_score": "",
            "failover": false,
            "customer_key": "6789901"
        }
    ]
}

Webhook participant left (host) payload data:

{
  account_id: 'XXXXXX',
  object: {
    uuid: 'XXXXXXX',
    participant: {
      leave_time: '2021-10-15T08:54:17Z',
      user_id: 'XXXXXX',
      user_name: 'Test User 1 (host)',
      registrant_id: '',
      id: 'Tj8XXXXXXX',
      leave_reason: 'left the meeting. Reason : Host ended the meeting.',
      email: ''
    },
    id: 'XXXXXXX',
    type: 2,
    topic: 'Test meeting for webhooks',
    host_id: 'XXXXX',
    duration: 10,
    start_time: '2021-10-15T08:53:27Z',
    timezone: 'America/Chicago'
  }
}

Webhook participant left (registered participant) payload data:

{
  account_id: 'XXXXXX',
  object: {
    uuid: 'XXXXXXX',
    participant: {
      leave_time: '2021-10-15T08:54:10Z',
      user_id: 'XXXXXX',
      user_name: 'Test User 2',
      registrant_id: 'XXXXXX',
      id: 'Fd1XXXXXXX',
      leave_reason: 'left the meeting',
      email: 'testemail@ourdomain.com'
    },
    id: 'XXXXXXX',
    type: 2,
    topic: 'Test meeting for webhooks',
    host_id: 'XXXXX',
    duration: 10,
    start_time: '2021-10-15T08:53:27Z',
    timezone: 'America/Chicago'
  }
}

It would be great if you can add to webhooks the field “customer_key”.

2

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.