Skip to main content

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:

FieldDescription
Application NameA descriptive name to identify your TeXML application
AnchorSiteDefines 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 methodHTTP method that will be used to interact with your webhooks
Webhook URLThe 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 URLA backup URL that Telnyx will use if the primary webhook URL fails to respond
Call progress events URLURL where Telnyx will send event callbacks related to your calls
Status Callback MethodHTTP method (GET or POST) used for status callbacks
Hang-up on timeoutSpecifies the number of seconds Telnyx will wait for initial application response before hanging up
DTMF TypeConfiguration for how DTMF (touch-tone) inputs are handled
Enable Call CostSpecify 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:

  1. Create a SIP trunking application by following the guide Configure SIP Trunking user guide
  2. 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.