Configuration of Call Control/TeXML Voice Apps
The Call Control / TeXML applications section is located on the left hand side of the portal under Voice > Programmable Voice.
Click on this button below and it will directly get you to the Voice Applications page.
Voice Applications (Call Control Voice API Application)
Voice App Name
Click on " Create your first application" and assign a name to this application to better manage the application.
Send a webhook to the URL
You will need to input a URL where all the webhook events will be sent. Also, you can setup a fail-over URL. If two consecutive delivery attempts to the primary URL fail, Telnyx will attempt delivery to this URL. NOTE: Must include a scheme such as 'https'.
Use Webhook API version
Determines which webhook format will be used based on the API version V1 or V2.
We recommend using API V2, as it contains a richer feature set versus the initial version which will be deprecated in the future.
Enable "hang-up" on timeout
When enabled, you will specify the number of seconds Telnyx will wait for commands from your application before hanging up.
Custom webhook retry delay (seconds)
In this field, you will need to specify a delay in seconds for Telnyx to wait before retrying an unsuccessful webhook delivery attempt. If not set, Telnyx will retry immediately.
AnchorSite® Selection
"Latency" directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.
DTMF Type
There are three types in this field: RFC 2833, Inband and SIP INFO.
RFC 2833: Default and preferred setting for most use cases, not audible on the call audio.
Inband: Digits are passed along just like the rest of your voice as normal audio tones.
SIP INFO: Mainly used for SIP to SIP calls. DTMF type is negotiated between parties on the call.
RTCP Capture
Enable capture of RTCP reports to build QoS Reports (found under Debugging > SIP Call Flow Tool). By default it's not enabled, clicked the "yes" radio button to enable it.
Call Cost Webhook Event
Specify if the call cost webhook should be sent. By default it's not enabled, clicked the "yes" radio button to enable it.
Inbound Settings
You can configure your global application settings for inbound calls over here.
Subdomain
Specify a subdomain that can be used to receive calls to a Connection, in the same way a phone number is used, from a SIP endpoint.
Example: the subdomain "example.sip.telnyx.com" can be called from any SIP endpoint by using the SIP URI "sip:@example.sip.telnyx.com" where the user part can be any alphanumeric value.
You only need to specify the subdomain in this field, there is no need to specify a Telnyx domain after it.
SIP subdomain receive settings: In this field, either you setup your receive SIP subdomain connection from anyone or only connections.
Inbound Channel Limit
You can limit the total number of inbound calls to phone numbers associated with this connection.
Enable Shaken Stir headers
By default, the radio button for no is checked. Select yes and save your settings if you want receive attestation information in the webhooks for incoming calls.
Codecs
Select the codes using the check mark boxes that you would like Telnyx to offer on your calls. You can force specific codecs by only checking one of the boxes.
Outbound settings
You can configure your global application settings for outbound calls over here.
Outbound Voice Profile
Assign your application to an outbound voice profile in order to make outbound calls.
Outbound Channel Limit
You can limit the total number of outbound calls to phone numbers associated with this connection.
Where can I find my Call Control application or app id?
Once you've successfully created your Call Control application, it is given an application id that can be seen within the application settings as seen in the below picture.
Why do I need an Call Control application or app id?
The application id is used to reference or trigger your API calls programmatically. Don't forget to reference our developer documentation to see how you can control your calls with the different API commands available.
TeXML Applications
TeXML App Name
Click on " Create your first application" and assign a name to this application to better manage the application.
Voice Method
In this field, HTTP request method Telnyx will use to interact with your XML Translator webhooks. Either "GET" or "POST".
Send a TeXML webhook to the URL
You will need to mention a URL where all the XML translator webhook events will be sent. Also, you can setup a fail-over URL. This URL to which Telnyx will deliver your XML Translator webhooks if we get an error response from your "Voice URL"
Status Callback Method
You will need to mention the HTTP request method Telnyx should use when requesting the "Status Callback" URL.
Send information about call progress events to the URL
Specify the URL for Telnyx to send requests to containing information about call progress events.
Enable "hang-up" on timeout
When enabled, you will specify the numbers of seconds to wait for actual application before hanging up.
AnchorSite® Selection
"Latency" directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.
DTMF Type
There are three types in this field: RFC 2833, Inband and SIP INFO.
RFC 2833: Default and preferred setting for most use cases, not audible on the call audio.
Inband: Digits are passed along just like the rest of your voice as normal audio tones.
SIP INFO: Mainly used for SIP to SIP calls. DTMF type is negotiated between parties on the call.
RTCP Capture
Enable capture of RTCP reports to build QoS Reports (found under Debugging > SIP Call Flow Tool). By default it's not enabled, clicked the "yes" radio button to enable it.
Call Cost Webhook Event
Specify if the call cost webhook should be sent. By default it's not enabled, clicked the "yes" radio button to enable it.
Inbound Settings
You can configure your global application settings for inbound calls over here.
Subdomain
Specify a subdomain that can be used to receive calls to a Connection, in the same way a phone number is used, from a SIP endpoint.
Example: the subdomain "example.sip.telnyx.com" can be called from any SIP endpoint by using the SIP URI "sip:@example.sip.telnyx.com" where the user part can be any alphanumeric value.
You only need to specify the subdomain in this field, there is no need to specify a Telnyx domain after it.
SIP subdomain receive settings: In this field, either you setup your receive SIP subdomain connection from anyone or only connections.
Inbound Channel Limit
You can limit the total number of inbound calls to phone numbers associated with this connection.
Enable Shaken Stir headers
By default, the radio button for no is checked. Select yes and save your settings if you want receive attestation information in the webhooks for incoming calls.
Codecs
Select the codes using the check mark boxes that you would like Telnyx to offer on your calls. You can force specific codecs by only checking one of the boxes.
Outbound settings
You can configure your global application settings for outbound calls over here.
Outbound Voice Profile
Assign your application to an outbound voice profile in order to make outbound calls.
Outbound Channel Limit
You can limit the total number of outbound calls to phone numbers associated with this connection.
Where can I find my TeXML application or app id?
Once you've successfully created your TeXML application, it is given an application id that can be seen within the application settings as seen in the below picture.
Why do I need an TeXML application or app id?
The application id is used to reference or trigger your API calls programmatically. Don't forget to reference our developer documentation to see how you can setup your XML instructions.