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.
Updated 2 months ago