Recording.Audio.Available

The Recording.Audio.Available webhook event is sent when the recorded conference in MP3 format is ready and can be downloaded through the URL link included in the webhook event. This event is available only for Dolby Voice conferences. The URL has a limited validity and expires after five minutes.

The splits webhook element allows receiving separate audio recordings for each conference participant. To use the split recording, enable the Generate audio recordings for each participant option in the dashboard.

To receive both video and audio recording formats, select the BOTH recording format output and use the Recording.MP4.Available and Recording.Audio.Available webhook events. The Recording.Audio.Available webhook only includes the links to the MP3 recordings.

Note: The layoutName and layoutUrl fields are only available for conferences that are not enabled with Dolby Voice as this information is only present with the use of a Mixer.

Split recording disabled:

{
  "conference": {
    "confId": "conference_identifier",
    "confAlias": "example_conference_alias"
  },
  "layoutName": "example_layoutName",
  "layoutUrl": "example_layoutUrl",  
  "thirdPartyId": "consumer_key",
  "region": "eu",
  "eventType": "Recording.Audio.Available",
  "filename": "example_file_name",
  "duration": 6400,
  "size": 78624,
  "url": "url_to_recording",
  "records": [
    {
      "startTime" : 1602086897206,
      "duration": 67540,
      "size": 10000,
      "filename": "record_{timestamp_epoch}_conf_{conference_id}.mp3",
      "url": "url_to_recording"
    },
    {
      "startTime" : 1602086897300,
      "duration": 1223,
      "size": 10000,
      "filename": "record_{timestamp_epoch}_conf_{conference_id}.mp3",
      "url": "url_to_recording"
    }
  ]
}

Split recording enabled:

{
    "conference": {
        "confId": "conference_identifier",
        "confAlias": "example_conference_alias"
    },
    "layoutName": "example_layoutName",
    "layoutUrl": "example_layoutUrl",  
    "thirdPartyId": "consumer_key",
    "region": "eu",
    "eventType": "Recording.Audio.Available",
    "filename": "example_file_name",
    "duration": 6400,
    "size": 78624,
    "url": "url_to_recording",
    "records": [
        {
            "startTime": 1602086897206,
            "duration": 6400,
            "size": 78624,
            "filename": "record_{timestamp_epoch}_conn_{user_id}_{user_record_start_time}.mp3",
            "url": "url_to_recording",
            "splits": [
                {
                    "startTime": 1602086897300,
                    "duration": 6420,
                    "size": 41256,
                    "filename": "record_{timestamp_epoch}_conn_{user_id}_{user_record_start_time}.mp3",
                    "userId": "userId_UUID",
                    "url": "url_to_recording",
                    "metadata": {
                        "preferSendMono": "false",
                        "externalName": "external_name",
                        "externalPhotoUrl": "link_to_participant_photo",
                        "simulcast": "false",
                        "preferRecvMono": "false"
                    }
                }
            ]
        }
    ]
}

Where:

  • startTime is the time when the conference started, in milliseconds since epoch.
  • region is the conference region, the possible values are:
    • ca: Canada
    • us: United States
    • eu: Europe
    • in: India
    • au: Australia
  • duration is the recording duration in milliseconds.
  • size is the recording file size in bytes.