<Record>

Record and store calls

Overview

Pivot will begin recording calls when this term is rendered. Pivot will not render additional terms until <Record> completes.

2600Hz will only store call recordings if the account has an appropriate storage plan setup. For accounts without storage for recordings, Pivot can send recordings to a developer server using the recordingUrl attribute. To retrieve calls stored by 2600Hz, see Kazoo API Call Recordings.

Attributes

NameValues DescriptionDefault value
finishOnKeyAny DTMF character0123456789*#
methodGET | POSTGET
playBeeptrue |falsetrue
maxLengthany positive integer (seconds)3600 (1 hour)
timeoutany positive integer including zero (seconds)5
actionURLnone
recordingUrlURLnone
recordStoreMethodPUT | POST | PATCHPUT

action

The URL where Pivot will make an HTTP request once the <Record> term completes. method sets the HTTP method of the request. Pivot expects another Pivot document in response as either 2600Hz JSON or TwiML, which will be rendered. Pivot never continues execution of the current document after an action, further terms will be unreachable.

finishOnKey

When pressed, this key finishes recording. <Record> will then complete. By default, any DTMF character will end recording.

maxLength

Pivot will stop recording after maxLength seconds and complete rendering <Record>.

method

Pivot sets the HTTP request method for the action request, either POST or GET. Pivot expects a response with more call instructions. See Requests for information about the request and response formats.

Defaults to GET.

playBeep

If set to true, Pivot will play a beep as recording starts.

Defaults to true.

timeout

Pivot will record silence on the line for timeout seconds before ending the recording. <Record> can still continue after a recording timeout.

timeout="0" will disable timeout.

recordingUrl

Kazoo will attempt to send recordings to this URL plus a generated media name when set. For example, when recordingUrl=myrecordings.com/pivot, Kazoo will send a recording to myrecordings.com/pivot/\[mediaName]

recordStoreMethod

Method to use when sending media to recordingUrl.