We're adding more flexibility when recording calls using TeXML, allowing you to choose between single- or dual-channel call recording more easily.
Recording calls using the TeXML
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.Telnyx passes information about recordings in the form of a webhook sent to the
recordingStatusCallback
andaction
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!
