<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
| Name | Values Description | Default value |
|---|---|---|
finishOnKey | Any DTMF character | 0123456789*# |
method | GET | POST | GET |
playBeep | true |false | true |
maxLength | any positive integer (seconds) | 3600 (1 hour) |
timeout | any positive integer including zero (seconds) | 5 |
action | URL | none |
recordingUrl | URL | none |
recordStoreMethod | PUT | POST | PATCH | PUT |
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.