Record | SignalWire

Verb attributes

action

string

The action attribute takes in an absolute or relative URL. SignalWire will make a GET or POST request to this URL when recording is completed. The current document’s URL will be requested if no action is provided which can lead to unwanted looping behavior if you’re not careful.

finishOnKey

string

The set of digits, (0-9, *, #), that can end a recording.

maxLength

integer

The maximum length, in seconds, of the recording. A value of zero means 3600 seconds.

method

stringDefaults to POST

The method attribute specifies whether the request to action is a GET or a POST. Valid values are GET or POST.

playBeep

booleanDefaults to true

Whether or not a sound is played before the start of a recording.

recordingStatusCallback

string

The recordingStatusCallback attribute takes in an absolute or relative URL. SignalWire will make a GET or POST request to this URL when recording is accessible.

recordingStatusCallbackEvent

stringDefaults to completed

The different recording statuses. Possible values are completed, in-progress, and absent. To specify multiple events, separate with a space.

recordingStatusCallbackMethod

stringDefaults to POST

The type of HTTP request to use when requesting a recordingStatusCallback.

storageUrl

string

The storageUrl attribute accepts an absolute URL as the destination to send a recording to, if you prefer to host your own recordings and bypass SignalWire storage.

storageUrlMethod

stringDefaults to POST

Specifies which HTTP verb to use when sending the recording to the storageUrl. Available values are: POST and PUT.

timeout

integer

The timeout attribute specifies the number of seconds of silence that ends a recording.

transcribe

booleanDefaults to false

The transcribe attribute identifies whether to produce a text transcription of the recording. There is an additional charge for this service, so is turned off by default.

transcribeCallback

string

The ability to define a URL to which SignalWire will make a POST request to once the transcription is complete.

trim

stringDefaults to trim-silence

Whether or not silence in the beginning and end of recordings are removed. Allowed values are trim-silence and do-not-trim.

the sound of silence

If no audio data is received, including when a caller is silent and trim-silence is enabled, SignalWire will not save a recording. If you wish to save silence, be sure to set trim="do-not-trim".

Note also that SignalWire will trim leading and trailing silence from your audio files, causing the duration of calls to be less than the time spent recording.

avoid looping

When recording finishes, including when no audio data is received, <Record> will always request its action URL and process the cXML instructions that are returned. If no action URL is set, SignalWire will re-request the current cXML document’s URL by default. This can lead to unwanted looping behavior, so make sure to end the call using action as seen in the

Request parameters for action URL

The action request contains the Standard Request Parameters as well as:

Digits

string

The buttons pressed to end a recording.

RecordingDuration

integer

The duration, in seconds, of the audio recording.

RecordingUrl

string

The URL of the recorded audio file.

Request parameters for recordingStatusCallback

Request parameters for transcribeCallback

Nesting

No other verbs can be nested within <Record> and you cannot nest <Record> within any other verbs.

Examples

Recording a voicemail

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say>
        Please leave a message at the beep.
        Press the pound key when finished.
    </Say>
    <Record
        action="http://your-application.com/handleRecording.php"
        method="GET"
        maxLength="15"
        finishOnKey="#"
        />
</Response>

This prompt will play before the ‘beep’, asking the caller to leave a message. The caller can only leave a message that is 15s long.

Transcribing a recording

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Record
        transcribe="true"
        transcribeCallback="http://your-application.com/handle_transcribe.php" />
</Response>

SignalWire will record the caller and transcribe the recording once it is complete. Then, SignalWire will make a POST request to the transcribeCallback URL with the transcription as a parameter.