Webhook details are not fulling the requirement

sandiban · ‎08-01-2022

Query from Mark Sheed over #webex4devs space -
Mark Shead • Trying to use Webhooks to keep track of who has joined or left a WebEx Meetings where many users don't have accounts. I need to get the display name and email address they entered. However, the Webhook only shows their display name. The email address can be obtained by making a call back to WebEx using their person ID, but users without accounts don't have person IDs from the webhook.
Is there anyway to query for the email address they used to join the meeting from the information provided in the webhook with the join information?

sandiban · ‎08-01-2022

Hi Mark,
Thanks for your patience so far!
I've tested the same and I believe below is the sample from Webhook when a participant is joining the meeting -

{
  "id": "Y2lzY29zcGFyazovL3VybjpURUFNOnVzLXdlc3QtMl9yL1dFQkhPT0svYTBlNmJjOWQtOWNmZC00NTI4LTlkNTEtYzEyZD...",
  "name": "MeetingJoineeTest",
  "targetUrl": "https://webhook.site/ea42fa6c-6ac3-4149-b453-5ccd....",
  "resource": "meetingParticipants",
  "event": "joined",
  "orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jNDI0NDcwZi0yNmI0LTQ5ZTItOGU3MC1kNWI...",
  "createdBy": "Y2lzY29zcGFyazovL3VzL1BFT1BMRS9hZjdmMzQ1Ni1lMmVjLTRlNjItYTExMS1hZm...",
  "appId": "Y2lzY29zcGFyazovL3VzL0FQUExJQ0FUSU9OL0NmMzkyNWU5NDFmMzhhYTc0M2Y0MmFiNzcwZmZhZjFhNTIyMjcxZDI5OTQ4NDh...",
  "ownedBy": "creator",
  "status": "active",
  "created": "2022-08-01T09:19:58.084Z",
  "data": {
    "id": "42a5cf79aca74070bd38a4fc9bf7e9c0_I_234501138266723198_fb41cb59-f4db-3334-a42a-c408b19...",
    "orgId": "c424470f-26b4-49e2-8e70-d5b39...",
    "displayName": "Sandip Banerjee",
    "state": "joined",
    "siteUrl": "sandip.webex.com",
    "meetingId": "42a5cf79aca74070bd38a4fc9bf7e9c0_I_234501138...",
    "hostEmail": "sbsrk3+test2@gmail.com",
    "devices": [
      {
        "correlationId": "241f7285-cb5a-41c5-a84c-072b6bbce0a0",
        "deviceType": "GCC_OS_MAC",
        "joinedTime": "2022-08-01T09:37:24Z",
        "leftTime": null
      }
    ],
    "hostPersonId": "Y2lzY29zcGFyazovL3VzL1BFT1BMRS9hZjdmMzQ1Ni1lMmVjLTRlNjItYTExMS...",
    "personId": "Y2lzY29zcGFyazovL3VzL1BFT1BMRS9mYzhlN2JkMy0yZTc3LTQ1OWEtOGE4Ni0yZDF..."
  }
}

Yes, it doesn't show the field email currently and only way to understand the person through DisplayName.
This is as per the current design.
If you want, You can tweak your meeting a little bit may be, so that when a Participant has to join the meeting only after registering hem/her-self.
To explore that option through /create-meeting REST API here, you can check for the 'registration' details in the documentation and you can enable those fields for Names (like, First Name, Last Name) as True.
So that, before joining the meeting, Users must have to registered themselves since email doesn't get generated in Webhook response currently.
Otherwise, you also have one more way to fetch the Participants details. You can take the personId from the very end of the Webhook notification details and pull the details from /get-a-person-details API as well using that personId. That way also, you can fetch the emailId, since emailId would be stored in that response.

And, if you want to raise it as a Webhook feature to directly access the email in Webhook Notification response, you can go to our AHA Portal here and raise a feature request, which platform is regularly monitored by our Product Management team, and based on the criticality of the Features, they prioritized the items.
Hope this should help you!
For any further query and assistance, please let us know.
Kind regards,
Sandip

mark.shead · ‎08-01-2022

Your suggestion of:

> You can take the personId from the very end of the Webhook notification details and pull the details from /get-a-person-details API as well using that personId.

Is what we were trying to do, but we found that PersonID does not appear to be populated if the person is just joining with a display name and email address. Is there something else we have to turn on to get the behavior you described?