More Recording Options for TeXML

We're adding more flexibility when recording calls using TeXML, allowing you to choose between single- or dual-channel call recording more easily.

How to specify Single-Channel Recording via TeXML

Recording calls using the TeXML

<Record>

verb produces a dual-channel recording by default.

Now, users can specify an additional

channels

attribute with the

<Record>

verb to produce a single-channel recording:

<Response>

  <Record channels="single" action="/test/callback/on-record" method="POST" recordingStatusCallback="/test/callback/recording" />

</Response>

The channels attribute can have a value of

"single"

or

"dual"

. The default value is

"dual"

, so if you're already using TeXML to record dual-channel calls, your integration won't be affected.

How this change affects webhook information passed by Telnyx

Telnyx passes information about recordings in the form of a webhook sent to the

recordingStatusCallback

and

action

URLs specified in the

<Record>

verb. With this change, the information in the webhooks will include a new

"RecordingChannels"

field. The

"RecordingChannels"

field can have a value of

"1"

for single-channel recordings or

"2"

for dual-channel recordings.

The webhook example shown below describes a single-channel call recording:

{

  "AccountSid": "9fd26e62-XXXX-XXXX-XXXX-XXXXXXXXXXXX",

  "CallSid": "v2:Yl-sKJ4znm3N7v9-nstE9oJNH48s4PfWVJ1UB5nsJMKHS9RqQ6gNdg",

  "CallSidLegacy": "v2:Yl-sKJ4znm3N7v9-nstE9oJNH48s4PfWVJ1UB5nsJMKHS9RqQ6gNdg",

  "From": "+1555XXXXXXX",

  "RecordingChannels": "1",

  "RecordingDuration": "4",

  "RecordingSid": "f1099038-XXXX-XXXX-XXXX-XXXXXXXXXXXX",

  "RecordingStatus": "completed",

  "RecordingUrl": "S3 URL",

  "To": "+1555XXXXXXX"

}

This change will be in effect from Monday, March 1, 2021. Want to learn more about recording calls with TeXML? Visit our API reference to explore the docs!