Record
The Record
verb creates an audio file with the call audio. If a recordingStatusCallback, Telnyx will deliver the URL for the recording to that address once the call has ended. Recording URLs are valid for 10 minutes after the call has ended. All recordings are also available via the Telnyx Mission Control Portal
Attributes
ATTRIBUTE | DESCRIPTION | OPTIONS | DEFAULT |
---|---|---|---|
action | Optional URL where TeXML will make a request when the Record ends to retrieve a new set of TeXML instructions to continue the call flow sent with additional request parameters. | - | |
method | HTTP request type used to retrieve the next set of instructions. | GET , POST | POST |
finishOnKey | Set of digits specified together, any one of which will end the recording. Supported character values: Any digit, #, *. | 1234567890*# | |
timeout | The number of seconds that Telnyx will wait for the recording to be stopped if silence is detected. The timer only starts when the speech is detected. Please note that the transcription is used to detect silence, and the related charge will be applied. 0 for infinite. | 0 | |
maxLength | Defines the maximum length for the recording in seconds. 0 for infinite. | 0 - 14400 | 3600 |
playBeep | Whether or not a sound is played before the start of a recording. | true | |
trim | Will remove silence from the beginning and end of the recording when set to trim-silence. | trim-silence | - |
channels | When using dual channels, the final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B. | single , dual | dual |
recordingStatusCallback | Optional URL that tells Telnyx where to make its GET or POST request when the recording is available. | - | |
recordingStatusCallbackMethod | HTTP request type used for recordingStatusCallback. | GET , POST | POST |
Example
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Record action="https://example.com/recording-complete"
maxLength="30"
playBeep="true"/>
</Response>