The Record verb starts recording in a call and pauses all BXML execution until the recording is terminated by a timeout (
maxDuration) or a terminating digit (
terminatingDigits). Once the recording ends, BXML execution will continue at the next verb, or at the BXML at the
recordCompleteUrl if this attribute is set.
recordingAvailableUrl attribute is set, this URL will receive a callback once the recording is available to use.
- You're capturing a voicemail
- You only need a single party recording
- You're capturing input that should pause the call until finished
The StartRecording verb starts recording in a call without pausing BXML execution. The PauseRecording, ResumeRecording, and StopRecording BXML verbs can be used to toggle the recording. Recording is terminated by either the call ending, or by a StopRecording verb.
Much like the Record verb, StartRecording also has a
recordingAvailableUrl attribute to receive the recording available callback.
- You want to record both ends (together or separate) of a phone call
- You want to record a call for quality assurance
- You need other BXML verbs to execute while a recording is going on
If you want your recordings to be transcribed, you can add a
transcribe attribute to your
StartRecording BXML verbs. If you want to receive a TranscriptionAvailable callback, you can additionally set the
transcriptionAvailableUrl to a URL on your callback server and
transcriptionAvailableMethod to its associated HTTP method (
POST, the default).
Transcription can succeed only for recordings of length greater than 500 milliseconds and less than 4 hours.