Record calls
Start recording a call
This endpoint lets you start recording a call.
API Endpoint
POST
Arguments
Parameter | Type | Description |
---|---|---|
time_limit | integer | Sets the maximum duration, in seconds, of the recording. Default: 60 |
file_format | string | The file format for the recording. Allowed values: mp3 , wav Default: mp3 |
transcription_type | string | auto : Transcription is automated; the turnaround time is under 5 minutes and increases with call duration. Transcription charges and details are available on the pricing page. |
transcription_url | string | The URL to which the transcription should be posted. Note: Transcription information is sent via HTTP POST callback. |
callback_url | string | The URL invoked when the recording ends. Details sent to this URL are documented in the Callback URL section. |
callback_method | string | The HTTP verb used to invoke the callback_url . Allowed values: GET , POST Default: POST |
record_channel_type | string | Specifies the recording channel type. Allowed values: mono , stereo Default: mono |
Transcription is available only in English and limited to calls with duration >500ms and <4 hours, and file size <2GB.
The transcription information is sent to this URL via an HTTP POST callback.
Callback URL
These details are posted when the callback URL is invoked after the recording ends.
List of parameters sent to the callback URL
Parameter | Type | Description |
---|---|---|
api_id | string | The API ID that was returned by the Record API. |
record_url | string | The URL where the recorded file can be accessed. |
call_uuid | string | The call_uuid of the call on which this recording was made. |
recording_id | string | The recording_id returned by the Record API. |
recording_duration | integer | The recording duration in seconds. |
recording_duration_ms | integer | The recording duration in milliseconds. |
recording_start_ms | integer | The start time of the recording since epoch in milliseconds. |
recording_end_ms | integer | The end time of the recording since epoch in milliseconds. |
List of parameters sent to the transcription URL
Parameter | Type | Description |
---|---|---|
transcription_charge | number | The credit deducted for the transcription. |
transcription | string | The transcribed text of the recording. |
duration | integer | The duration in seconds of the recording. |
call_uuid | string | The call UUID of the call that was transcribed. |
transcription_rate | number | The rate of the transcription per minute. |
recording_id | string | The recording ID of the transcribed recording. |
error | string | May be Recording duration too long for transcription or Recording file size too large for transcription . Empty if transcription is successful. |
.mp3 files are smaller in size than .wav files. Consider changing the recording file format to .mp3 if you see this error.
Returns
If successful, this endpoint returns an acknowledgement that the recording has started along with a URL to access the recording.