Multiparty call recording
Start Recording a Multiparty Call
This endpoint starts recording a Multiparty Call.
POST
Arguments
Parameter | Description |
---|---|
file_format | Format of the recording. - Allowed values: mp3, wav. - Defaults to mp3. |
recording_callback_url | URL to which status update events for this recording should be posted. |
recording_callback_method | HTTP verb used to invoke the URL configured as status_callback_url . - Allowed values: GET, POST. - Defaults to POST. |
A Supervisor’s voice will be recorded regardless of the coach_mode setting.
List of events and parameters sent to the recording_callback_url
These events are generated:
- MPCRecordingInitiated
- MPCRecordingPaused
- MPCRecordingResumed
- MPCRecordingCompleted
- MPCRecordingFailed
This information is sent to the URL when an event is triggered:
EventName string | Event that triggered this notification. This parameter will have one of the values from the list of events above. |
EventTimestamp string | Timestamp at which the event occurred. Format: YYYY-MM-DD HH:mm:ss+-hh:mm |
MPCName string | Friendly name provided during the creation of the MPC. |
MPCUUID string | Unique ID of the Multiparty call. |
RecordingDuration string | Duration of recording in seconds. |
RecordingEndTime string | Timestamp at which the recording ended. Format: YYYY-MM-DD HH:mm:ss+-hh:mm |
RecordingFormat string | Format of the recording. |
RecordingResourceURL string | Resource URL of the recording file. You can use this URL to fetch the recording details later. |
RecordingStartTime string | Timestamp at which the recording started. Format: YYYY-MM-DD HH:mm:ss+-hh:mm |
RecordingURL string | Complete path to the recorded file URL. |
RecordingUUID string | Unique identifier to identify the file. |
SequenceNumber string | Indicates the sequence of the callback. Helpful to sort the callback events posted to the recording_callback_url. |
Returns
If successful, this endpoint returns an acknowledgement that the recording has started, along with a URL to access the recording.