TeXML fundamentals
Overview
TeXML is an XML-based data structure used to build quick voice applications designed to be a simple yet powerful way to control phone calls using a set of dedicated Verbs and Nouns.
See Verbs & Nouns for detail.
TeXML Application
A TeXML Application is a configuration entity that defines how Telnyx handles your voice calls. It serves as the central point for managing both inbound and outbound calls through TeXML instructions.
TeXML Application Configuration
When creating a TeXML Application, you will need to configure the following fields:
Field | Description |
---|---|
Application Name | A descriptive name to identify your TeXML application |
AnchorSite | Defines preferable data center for handling the traffic. In case of latency ICMP ping to the webhook URL address will be used to calculate the closed data center. |
Voice method | HTTP method that will be used to interact with your webhooks |
Webhook URL | The URL where Telnyx will fetch TeXML instructions when a call is initiated. The instruction can be served by Telnyx. In that case select TeXML bin URL . See TeXML bin quickstart for more details. |
Webhook Failover URL | A backup URL that Telnyx will use if the primary webhook URL fails to respond |
Call progress events URL | URL where Telnyx will send event callbacks related to your calls |
Status Callback Method | HTTP method (GET or POST) used for status callbacks |
Hang-up on timeout | Specifies the number of seconds Telnyx will wait for initial application response before hanging up |
DTMF Type | Configuration for how DTMF (touch-tone) inputs are handled |
Enable Call Cost | Specify if the call cost webhook should be sent |
Creating a TeXML Application
You can create a TeXML Application through the Telnyx Mission Control Portal or via the Telnyx API.
Using SIP Trunking application
In order to use Sip Trunking application with TeXML:
- Create a SIP trunking application by following the guide Configure SIP Trunking user guide
- To enable TeXML processing:
- provide the Webhook URL - Telnyx will send the instruction fetch requests to It
- select Webhook API version to TeXML
- and enable
Park all outbound calls
option
Receiving and making calls
See Instruction fetching tutorial to learn how to make and receive calls using TeXML applications.
Twilio Compatibility
See Twilio Compatibility for detail.