2020 API AWARDS WINNER - BEST IN MEDIA APIs LEARN MORE

Recording.MP4.Available

The Recording.MP4.Available event is sent when the MP4 file of the recorded conference is available for download at the specified url in the payload.

The splits element contains audio recordings for individual participants, identified by the participant ID. This feature can be enabled in the developer portal and by default it is disabled. Video recordings are merged into a single file.

The type of the recording depends on the settings in the developer portal, for more information refer to this page.

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": "00000000-aaaa-bbbb-cccc-000000000000",
    "confAlias": "00000000-aaaa-bbbb-cccc-000000000001"
  },
  "thirdPartyId": "thirdparty_id",
  "splits": null,
  "region": "eu",
  "duration": 67540,
  "eventType": "Recording.MP4.Available",
  "url": "url_to_audio_recording"
}

split recording enabled

{
  "eventType": "Recording.MP4.Available",
  "conference": {
    "confId": "00000000-aaaa-bbbb-cccc-000000000000",
    "confAlias": "sampe_conference"
  },
  "url": "url_to_recording",
  "thirdPartyId": "thirdparty_id",
  "splits": {
    "00000000-aaaa-bbbb-cccc-000000000001": {
      "url": "url_to_recording",
      "metadata": {
        "externalPhotoUrl": "link_to_participant_photo",
        "externalId": "external_id",
        "externalName": "Luqman"
      }
    },
    "00000000-aaaa-bbbb-cccc-000000000002": {
      "url": "url_to_audio_recording",
      "metadata": {
        "externalPhotoUrl": "link_to_participant_photo",
        "externalId": "external_id",
        "externalName": "Atajus"
      }
    }
  }
}