Recording.MP4.Available

The Recording.MP4.Available webhook event is sent when the recorded conference in the MP4 format is ready and can be downloaded through the included URL link. The webhook event is available for Dolby Voice and non-Dolby Voice conferences:

  • Dolby Voice conferences: The webhook event includes links to MP4 recordings.
  • Non-Dolby Voice conferences: The webhook event can include links to MP3 and MP4 recordings, depending on the selected recording format. The BOTH recording option allows receiving links to MP3 and MP4 recordings and does not allow receiving separate recordings for selected conference participants (split recording).

The splits webhook element allows receiving separate audio recordings for each conference participant. This option, in the case of Recording.MP4.Available, is only available for audio recordings in MP3 format in the case of non-Dolby Voice conferences. To use the split recording, enable the Generate audio recordings for each participant option in the dashboard.

To receive both recording formats in the case of Dolby Voice conferences, select the BOTH recording format and use Recording.MP4.Available and Recording.Audio.Available webhook events.

Note: Due to S3 high availability replication, webhook events may experience mild latency, as it takes time to replicate across S3 servers. Files on S3 should be available within milliseconds after the webhook is sent. However, we recommend implementing a back-off retry mechanism, in the event that the file download fails. For more information, refer to this page.

Split recording disabled:

{
  "conference": {
    "confId": "conferenceId_UUID",
    "confAlias": "example_conference_alias"
  },
  "thirdPartyId": "example_thirdpartyId",
  "splits": null,
  "region": "eu",
  "duration": 67540,
  "eventType": "Recording.MP4.Available",
  "url": "url_to_recording"
}

Split recording enabled:

{
  "conference": {
    "confId": "conferenceId_UUID",
    "confAlias": "example_conference_alias"
  },
  "url": "url_to_recording",
  "thirdPartyId": "example_thirdpartyId",
  "splits": {
    "userId_UUID_01": {
      "url": "url_to_recording",
      "metadata": {
        "preferSendMono": "false",
        "externalId": "external_id",
        "simulcast": "false",
        "preferRecvMono": "false",
        "externalName": "Luqman"
        "externalPhotoUrl": "link_to_participant_photo"
      }
    },
    "userId_UUID_02": {
      "url": "url_to_recording",
      "metadata": {
        "preferSendMono": "false",
        "externalId": "external_id",
        "simulcast": "false",
        "preferRecvMono": "false",
        "externalName": "Atajus"
        "externalPhotoUrl": "link_to_participant_photo"
      }
    }
  },
  "region": "eu",
  "duration": 6400",
  "eventType": "Recording.MP4.Available",
}