The element is used to record audio during a call. It can occur anywhere within an InboundXML document but will only begin recording once it has been reached. This means it would have to be the first element after for the entire call to be recorded.
When the recording is complete, a URL of the recorded audio is created and submitted as a GET or POST to the action URL. Similar to the element, a timeout value sets how much silence to allow before the recording ends, maxLength sets how long the recording may be, and the finishOnKey is used to set which keys will end the recording.
By default, the action and method specify that should make a POST to the URL of the current InboundXML document.
URL where some parameters specific to will be sent for further processing.
Method used to request the action URL.
The number of seconds should wait during silence before ending.
The key a caller can press to end the.
The maximum length in seconds a recording should be.
Boolean value specifying if a beep should be played when the recording begins.
The recording file format. Can be mp3 or wav.
Begin recording the call while continuing the execution of any other present InboundXML in the background (true) or block the execution of subsequent InboundXML until the record element finishes (via finishOnKey or timeout). Note that the timeout, finishOnKey, and playBeep attributes have no effect when the background is set to true.
Trims all silence from the beginning of the recording. Any other value will default to “false”.
The following is a set of properties that are sent along with the action URL.
A unique id that will be created when recording is started for each call.
A valid mp3 or wav audio file URL which contains the recording.
The time when recording is started.
The duration of the recording in seconds.
The direction of the recording, either inbound or outbound.
The unique id that will be created for each call.
A valid Ytel API AccountSid
A valid 10-digit number (E.164 format) that will be initiating the phone call.
A valid 10-digit number (E.164 format) that will receive the phone call.
The element cannot be nested within any other verbs besides the default element. The element cannot nest any other elements within itself.
<Response> <Say>Please state your name.</Say> <Record background="false" action="http://your-url.com/" timeout="100" method="POST" finishOnKey="#"></Record> </Response>
Updated over 1 year ago