At Telnyx we’re always improving and iterating on our Voice API (Call Control), we make changes regularly based on feedback we receive from users like you.
Recent Updates to Call Control include:
23 February 2021
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": "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!
10 February 2021
We've implemented a bug fix to prevent audio playback from being interrupted on calls.
When gathering user inputs using the TeXML <Gather> verb or the gatherusingaudio Call Control command, audio can be played to prompt the user. In this situation, a user's keypad button presses will interrupt the audio playback.
However, when playing custom audio on a call, using either the TeXML <Play> verb or the playback_start Call Control command, and without specifying any input gathering, audio could unintentionally be interrupted by a user pressing the * key on their phone keypad.
Now, when custom audio is being played on a call using the TeXML <Play> verb or the Call Control playback_start command, and no input gathering is active, the audio will not be interrupted by any button presses unless the call is hung-up.
Find out how your fellow developers have been using custom audio playback - join our Developer Slack Community today!
04 December 2020
If you're a Telnyx API user, you can now retrieve detailed information about webhooks for your account with our new Webhook Logging tools.
A webhook (also referred to as a web callback or a HTTP push API) is a way for an app to deliver data to other apps in real-time. Webhooks provide Telnyx API users with notification and context on communications events as they happen, enabling real-time communications applications.
For example, webhooks are sent by a Telnyx Call Control application when a call is initiated (call.initiated), answered (call.answered) or hung up (call.hangup). The Telnyx API sends webhooks to notify your application of a wide variety of events, including phone calls and numbers, text messages, SIP configuration settings, and many more as detailed in our API Reference.
Webhook Logging allows you to retrieve webhooks that have already been delivered by Telnyx about events in your voice and messaging applications.
Granular filtering options allow you to refine your search with several webhook parameters, including status, time-frame, and text strings contained in the webhook. These filtering tools enable advanced debugging use-cases:
call.initiated) to find anomalies.Webhook Logging is the newest addition to our growing suite of advanced communications API debugging tools. With granular debugging and reporting, it's easier than ever to build next-generation communications apps on our voice and texting APIs.
Webhook Logging tools can be accessed via the Telnyx API's /webhook_deliveries endpoint.
The Telnyx API Reference contains documentation and usage examples for listing webhook deliveries and filtering results, and for finding webhook delivery details by webhook ID.
23 November 2020
We’re excited to announce that Telnyx Voice API users can now transfer calls using the SIP Refer method. SIP Refer enables greater control over your communications by providing a reliable means of transferring calls between parties within your organization, or to the PSTN.
Customers can request that a call be transferred by using Call Control, our programmable voice API. Refer commands can be sent from a Call Control application at any time during a call. This will initiate a transfer of one of the parties from the initial Telnyx call onto a new call to an external destination, without Telnyx in the call path.
This transfer method can also be used to establish a new call between the two parties from the initial Telnyx call, without Telnyx in the call path. This use-case is especially useful for calls on which sensitive information is disclosed - by removing itself from the call path, Telnyx adds an extra layer of protection to these calls.
Initiating a transfer on any Telnyx call using the Refer command adds a $0.10 surcharge to the cost of the call.
Context can be passed along with transferred calls in the form of SIP UUI headers. For example, a support agent who collects information from a customer can attach this information in SIP UUI headers when transferring the call to another support agent, ensuring the customer only needs to provide their information once.
For more information on transferring calls using SIP REFER, check out our docs. Note that this new functionality is not supported in V1 of our API.
Curious about using SIP REFER to build greater functionality into your comms? Talk to our SIP experts to learn more.
13 February 2020
We’re excited to announce a new Voice feature: Park Outbound Calls. This feature is now available in the Mission Control Portal and Telnyx API.
The Park Outbound Calls feature provides a simple mechanism for users to “park” their outbound calls instead of connecting them to their destination. The call then awaits further orders from its connected application.
Parked calls provide a ringback to the caller, waiting for a command via the Telnyx Call Control API to define the call action. Typical commands include answer, play audio, bridge to another call, and transfer to another number. You can learn more about Call Control commands in our Developer Docs.
By default, this new feature is not enabled on Connections. To enable Park Outbound Calls for your Connections, follow the steps below:
To use our Park Outbound Calls feature, head to the Mission Control Portal or check out our support docs learn more.
22, August 2019
We’re delighted to announce the launch of Telnyx Answering Machine Detection, now available with the programmable voice API — Call Control. Using Answering Machine Detection, you can deliver a better calling experience, at the same time gathering valuable data about how often your outbound calls are picked up by humans or machines.
Outbound calling is a critical communication channel for many businesses, whether you’re following up on potential sales leads, providing customers with important updates, or collecting customer data via voice surveys.
The first step in delivering a great experience is understanding who’s answering the call. Telnyx Answering Machine Detection will tell you in real-time whether your call has been answered by a human or machine, so you can tailor your experience accordingly.
Answering Machine Detection (AMD) is a feature that determines whether a machine or a human answered a call. It can be applied to any automated outbound call, including outbound IVRs, text-to-speech, pre-recorded calls and click-to-call.
When initiating a call using the Telnyx voice API, simply choose an answering machine detection configuration. Then, once the call is answered our AMD algorithm will automatically detect in real-time if a human or machine has picked up the call. Telnyx will automatically send you webhooks when:
Choose one of our out of the box configurations, or build your own configuration using our flexible parameters.
AMD can be used by any business using automated outbound calling. Answering Machine Detection adds value to these channels by differentiating messages when they’re picked up by an answering machine or voicemail. Some of the most common use cases include:
Did you know that 80% of phone calls go straight to voicemail? And, sales reps spend an average of 25 hours a month leaving voicemail messages. Answering Machine Detection brings with it a host of benefits, boosting agent productivity, increasing agent talktime, and driving sales conversions— all by ensuring agent time is spent on live calls with prospective customers.
Answering Machine Detection also enables businesses to improve their customer experiences (CX), automating the proactive distribution of critical information, and automating callbacks, so customers are guaranteed to receive the call they’ve requested.
Telnyx Answering Machine Detection is free of charge with the Telnyx Programmable Voice API - Call Control, so you only pay for the call cost, starting at just $0.002 per minute. Twilio’s equivalent is charged at $0.0075 per call, on top of a minimum of $0.004 per minute for the call. So, Telnyx is a far more cost-effective option if you want to use this feature.
To get started using Telnyx Answering Machine Detection, the first step is to sign up for a free portal account. Then, follow the steps in the quickstart guide to get set up to make outbound calls. Finally, check out the Answering Machine Detection API docs for specific information about how to configure AMD with your application.
Answering Machine Detection enhances an extensive suite of features already available on the Telnyx programmable voice API. Other available features include the ability to record and conference calls, play audio, fork call media, capture caller inputs and more.
Questions? Join our 24/7 developer slack channel or get in touch with our team of experts.