curl -L 'https://api.telnyx.com/v2/texml/Accounts/:account_sid/Calls' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
  "ApplicationSid": "xxxxxxxx",
  "To": "+13121230000",
  "From": "+13120001234",
  "Url": "https://www.example.com/texml.xml",
  "StatusCallback": "https://www.example.com/statuscallback-listener"
}'

GET /texml-instructions?
  AccountSid=6a9a7976-012e-45d2-9258-6f5dc68d861e&
  CallSid=fcc47bc6-e428-11ed-ad79-02420aef00b4&
  CallSidLegacy=fcc47bc6-e428-11ed-ad79-02420aef00b4&
  From=%2B13122010091&
  To=%2B13122010090&
  ConnectionId=1568109700606592442&
  CallStatus=in-progress

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say>Welcome to the Telnyx TeXML service.</Say>
  <Gather timeout="5" numDigits="1">
    <Say>Press 1 to continue.</Say>
  </Gather>
</Response>

<?xml version="1.0" encoding="UTF-8"?>

<!-- TeXML files must contain the Response element -->
<Response>
 <!-- Say and Dial are Verbs -->
    <Say>Thank you for calling Telnyx. Please hold.</Say>
    <Dial>
   <!-- Number is a Dial Noun -->
        <Number>+13129457420</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Number>{{PhoneNumber}}</Number>
  </Dial>
</Response>

curl -X POST https://api.telnyx.com/v2/texml/calls/{connection_id} \
--data-urlencode "To=+13121230000" \
--data-urlencode "From=+13120001234" \
--data-urlencode "Url=https://www.example.com/texml.xml?PhoneNumber=+18771234567" \
--data-urlencode "StatusCallback=https://www.example.com/statuscallback-listener" \
--header "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.telnyx.com/v2/texml/calls/{connection_id} \
--data-urlencode "To=+13121230000" \
--data-urlencode "From=+13120001234" \
--data-urlencode "Url=https://www.example.com/texml.xml?PhoneNumbers[]=+18771234567&PhoneNumbers[]=+18771234568" \
--data-urlencode "StatusCallback=https://www.example.com/statuscallback-listener" \
--header "Authorization: Bearer YOUR_API_KEY"

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
  {{#PhoneNumbers}}
    <Number>{{.}}</Number>
  {{/PhoneNumbers}}
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Number>+18771234567</Number>
    <Number>+18771234568</Number>
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
{{#if From == +18771234567}}
  <Dial>
    <Number>+18771234568</Number>
  </Dial>
{{#elseif From == +18771234568}}
  <Dial>
    <Number>+18771234567</Number>
  </Dial>
{{#else}}
  <Say>No valid number is present</Say>
{{/if}}
</Response>

  <?xml version="1.0" encoding="UTF-8"?>
  <Response>
    <Dial>
       <Number>{{PhoneNumber}}</Number>
    </Dial>
  </Response>

    curl -X POST https://api.telnyx.com/v2/texml/calls/{connection_id} \
    --data-urlencode "To=+13121230000" \
    --data-urlencode "From=+13120001234" \
    --data-urlencode "Url=https://www.example.com/texml.xml?PhoneNumber=+18771234567" \
    --data-urlencode "StatusCallback=https://www.example.com/statuscallback-listener" \
    --header "Authorization: Bearer YOUR_API_KEY"

    curl -X POST https://api.telnyx.com/v2/texml/calls/{connection_id} \
    --data-urlencode "To=+13121230000" \
    --data-urlencode "From=+13120001234" \
    --data-urlencode "Url=https://www.example.com/texml.xml?PhoneNumbers[]=+18771234567&PhoneNumbers[]=+18771234568" \
    --data-urlencode "StatusCallback=https://www.example.com/statuscallback-listener" \
    --header "Authorization: Bearer YOUR_API_KEY"

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    {{#PhoneNumbers}}
       <Number>{{.}}</Number>
    {{/PhoneNumbers}}
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Number>+18771234567</Number>
    <Number>+18771234568</Number>
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
{{#if {{From}} == +18771234567}}
  <Dial>
    <Number>+18771234568</Number>
  </Dial>
{{#elseif {{From}} == +18771234568}}
  <Dial>
    <Number>+18771234567</Number>
  </Dial>
{{#else}}
  <Say>No valid number is present</Say>
{{/if}}
</Response>

    <Response>
        <HttpRequest>
            <Request url="https://example.com" method="POST">
                <Headers>
                    <Header>
                        <Key>Authorization</Key>
                        <Value>Bearer API_key</Value>
                    </Header>
                    <Header>
                        <Key>Content-Type</Key>
                        <Value>application/json</Value>
                    </Header>
                </Headers>
                <Body>
                <![CDATA[
                        {
                            "key":"value"
                        }
                        ]]>
                </Body>
            </Request>
        </HttpRequest>
    </Response>

    <Response>
    <HttpRequest>
        <Request url=”https://example.com” method=”POST” async=”true”>
        <Headers>
            <Header>
                <Key>Authorization</Key>
                <Value>Bearer API_key</Value>
            </Header>
            <Header>
                <Key>Content-Type</Key>
                <Value>application/json</Value>
            </Header>
        </Headers>
        <Body>
        <![CDATA[
                {
                    “from”:{{From}}
                }
                ]]>
        </Body>
        </Request>
    </HttpRequest>
    </Response>

    <Response>
        <HttpRequest>
            <Request url=”https://example.com” method=”POST” async=”true”>
            <Headers>
                <Header>
                    <Key>Authorization</Key>
                    <Value>Bearer API_key</Value>
                </Header>
                <Header>
                    <Key>Content-Type</Key>
                    <Value>application/json</Value>
                </Header>
            </Headers>
            <Body>
            <![CDATA[
                    {
                        “from”:{{From}}
                    }
                    ]]>
            </Body>
            </Request>
            <Response>
                <Type>JSON</Type>
                <StatusCode>200</StatusCode>
                <Content>
                    <Field>
                        <Name>contact.name.first</Name>
                        <Value>first_name</Value>
                    </Field>
                    <Field>
                        <Name>contact.name.last</Name>
                        <Value>last_name</Value>
                    </Field>
                </Content>
                </Response>
        </HttpRequest>
    </Response>

    curl --location --request POST 'https://api.telnyx.com/v2/texml/secrets/' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "name":"your_secret_name",
        "value":"your_secret_value"
    }'

    <Response>
        <HttpRequest>
            <Request url=”https://example.com” method=”POST” async=”true”>
            <Headers>
                <Header>
                    <Key>Authorization</Key>
                    <Value>Bearer {{#secret}}your_secret_name{{/secret}}</Value>
                </Header>
                <Header>
                    <Key>Content-Type</Key>
                    <Value>application/json</Value>
                </Header>
            </Headers>
            <Body>
            <![CDATA[
                    {
                        “from”:{{From}}
                    }
                    ]]>
            </Body>
            </Request>
        </HttpRequest>
    </Response>

        curl --location --request POST 'https://api.telnyx.com/v2/texml/secrets/' \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data-raw '{
            "name":"slack_api_key",
            "value":"your_api_key_value"
        }'

        curl --location --request POST 'https://api.telnyx.com/v2/texml/secrets/' \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data-raw '{
            "name":"salesforce_token",
            "value":"your_token_value"
        }'

        <Response>
            <HttpRequest async="true">
                <Request url="https://slack.com/api/chat.postMessage" method="POST">
                    <Headers>
                        <Header>
                            <Key>Authorization</Key>
                            <Value>Bearer {{#secret}}slack_api_key{{/secret}}</Value>
                        </Header>
                        <Header>
                            <Key>Content-Type</Key>
                            <Value>application/json</Value>
                        </Header>
                        </Headers>
                    <Body>
                    <![CDATA[
                                {
                                    "Channel": channel_id,
                                    "text":"You have a call from {{caller_name}}!"
                                }
                                ]]>
                    </Body>
                </Request>
            </HttpRequest>
            <Dial>
                <Sip>
                    sip:jack@example.com
                </Sip>
            </Dial>
        </Response>

        <Response>
            <HttpRequest action="https://api.telnyx.com/v2/media/slack_http_request.xml" async="false">
                <Request url="https://your_salesforce _domain.my.salesforce.com/services/data/v56.0/query?q=SELECT%20name%20from%20Account%20WHERE%20Phone%3D%27{{#url_encode}}{{From}}{{/url_encode}}%27" method="GET" >
                    <Headers>
                    <Header>
                        <Key>Authorization</Key>
                        <Value>Bearer {{#secret}}salesforce_token{{/secret}}</Value>
                    </Header>
                    <Header>
                        <Key>Content-Type</Key>
                        <Value>application/json</Value>
                    </Header>
                    </Headers>
                    <Body>
                    </Body>
                </Request>
                <Response>
                    <Type>JSON</Type>
                    <StatusCode>200</StatusCode>
                    <Content>
                    <Field>
                        <Name>records[0].Name</Name>
                        <Value>caller_name</Value>
                    </Field>
                    </Content>
                </Response>
            </HttpRequest>
        </Response>

    curl --request POST \
      --url https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Calls \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
      "From": "+13127367421",
      "To": "your-sip-user@sip.telnyx.com",
      "Url": "https://your-server.example.com/texml/instructions",
      "FallbackUrl": "https://your-server.example.com/texml/fallback",
      "StatusCallback": "https://your-server.example.com/callback/status",
      "StatusCallbackMethod": "POST",
      "Method": "POST",
      "MachineDetection": "Enable",
      "DetectionMode": "Premium",
      "AsyncAmd": false
    }'

    curl --request POST \
      --url https://api.telnyx.com/v2/texml/Accounts/{account_sid}/Calls \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
      "From": "+13127367421",
      "To": "your-sip-user@sip.telnyx.com",
      "Url": "https://your-server.example.com/texml/instructions",
      "FallbackUrl": "https://your-server.example.com/texml/fallback",
      "Method": "POST",
      "StatusCallback": "https://your-server.example.com/callback/status",
      "StatusCallbackMethod": "POST",
      "MachineDetection": "Enable",
      "DetectionMode": "Premium",
      "AsyncAmd": true,
      "AsyncAmdStatusCallback": "https://your-server.example.com/callback/amd-status",
      "AsyncAmdStatusCallbackMethod": "POST"
    }'

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Number>+18775551212</Number>
    <Sip>sip:connection@sip.telnyx.com</Sip>
    <Number>+18771234567</Number>
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial sequential="true">
    <Number>+18775551212</Number>
    <Sip>sip:connection@sip.telnyx.com</Sip>
    <Number>+18771234567</Number>
  </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">+19999999999</Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">
      <Number statusCallback="https://foo.com/my_call_stats" statusCallbackEvent="initiated ringing answered completed">+19999999999</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234" hangupOnStar="true">
      <Sip statusCallback="https://foo.com/my_sip_call_stats" statusCallbackEvent="initiated">sip:connection@sip.telnyx.com</Sip>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">
      <Number statusCallback="https://foo.com/my_call_stats" statusCallbackEvent="initiated ringing answered completed amd" machineDetection="Enable" detectionMode="Regular">+19999999999</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">
      <Number statusCallback="https://foo.com/my_call_stats" statusCallbackEvent="initiated ringing answered completed amd" machineDetection="Enable" detectionMode="PremiumCallScreening" machineDetectionPromptEndTimeout="5000">+19999999999</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">
      <Number deepfakeDetection="Enable" deepfakeDetectionCallbackUrl="https://foo.com/deepfake_results">+19999999999</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial action="/nextinstructions.php" callerId="+13120001234">
      <Number statusCallback="https://foo.com/my_call_stats" statusCallbackEvent="deepfake completed" deepfakeDetection="Enable" machineDetection="Enable">+19999999999</Number>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say voice="alice">This is a premium Amazon Polly text-to-speech message!</Say>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Play>https://example.com/welcome.mp3</Play>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Play ringTone="us" loop="3"/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Play continueOnError="true">https://example.com/might-404.mp3</Play>
    <Say>Sorry, we could not play the message.</Say>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Play failoverUrl="https://cdn-backup.example.com/welcome.mp3">https://cdn.example.com/welcome.mp3</Play>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Gather timeout="5" numDigits="1" finishOnKey="#">
        <Say>Press 1 for sales, press 2 for support.</Say>
    </Gather>
</Response>

<Response>
     <AIGather action="/after_ai_gather">
    <Greeting></Greeting>
    <Parameters>
    <![CDATA[
    {
      "properties": {
        "age": {
          "description": "The age of the customer.",
          "type": "integer"
        },
        "location": {
          "description": "The location of the customer.",
          "type": "string"
        }
      },
      "required": [
        "age",
        "location"
      ],
      "type": "object"
    }
    ]]>
    </Parameters>
    <Voice name="Telnyx.NaturalHD.Astra" voice_speed="1.0"/>
    <MessageHistory>
      <Message role="user">Hello my name is Enzo.</Message>
    </MessageHistory>
    <InterruptionSettings enable="true"/>
    <Transcription model="some_model"/>
    <Assistant model="openai/gpt-4" api_key_ref="my_key_ref" instructions="You are a helpful assistant that can help the customer with their questions.">
      <Tools>
        <Tool>
          <![CDATA[
          {
            "type": "hangup",
            "hangup": {
              "description": "Hang up the call."
            }
          }
          ]]>
        </Tool>
        <Tool>
          <![CDATA[
          {
            "type": "transfer",
            "transfer": [
              {
                "name": "support",
                "to": "+1234567890"
              }
            ]
          }
          ]]>
        </Tool>
      </Tools>
    </Assistant>
  </AIGather>
</Response>

<Response>
    <Connect>
        <AIAssistant id=\"assistant-776d0d6f-716d-4d8f-b6da-b95181636838\">
        </AIAssistant>
    </Connect>
</Response>

<!-- Join an existing AI assistant conversation -->
<Response>
    <Connect>
        <AIAssistant join=\"v3:abc123def456\" participantName=\"John\" participantRole=\"user\">
        </AIAssistant>
    </Connect>
</Response>

<!-- Transfer to an agent when the assistant conversation ends with an error -->
<Response>
    <Connect action=\"https://example.com/after-assistant\" method=\"POST\">
        <AIAssistant id=\"assistant-776d0d6f-716d-4d8f-b6da-b95181636838\">
        </AIAssistant>
    </Connect>
</Response>

<!-- Example response returned by the action URL on a server-error reason -->
<Response>
    <Dial>+15551234567</Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Record action="https://example.com/recording-complete"
            maxLength="30"
            playBeep="true"/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say voice="Telnyx.KokoroTTS.af">This call will be recorded and transcribed for quality purposes.</Say>
  <Record
    action="https://example.com/recording-complete"
    method="POST"
    maxLength="60"
    timeout="5"
    transcription="true"
    transcriptionEngine="A"
    transcriptionCallback="https://example.com/transcription-result" />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say voice="Telnyx.KokoroTTS.af">This call will be recorded and transcribed for quality purposes.</Say>
  <Record
    action="https://example.com/recording-complete"
    method="POST"
    maxLength="60"
    transcription="true"
    transcriptionEngine="Deepgram"
    transcriptionModel="deepgram/nova-3"
    transcriptionLanguage="en-US"
    transcriptionCallback="https://example.com/transcription-result" />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial  action="/nextinstructions.php">
        <Conference>conference_name</Conference>
    </Dial>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Enqueue/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Hangup/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pause length="5"/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         chargeAmount="10.50"
         currency="USD"
         transactionType="charge"
         action="https://example.com/payment-complete"
         statusCallback="https://example.com/pay-status" />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         transactionType="tokenize"
         action="https://example.com/payment-complete"
         statusCallback="https://example.com/pay-status" />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         paymentMethod="ach-debit"
         transactionType="charge"
         chargeAmount="25.00"
         currency="USD"
         action="https://example.com/payment-complete"
         statusCallback="https://example.com/pay-status" />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         transactionType="charge"
         chargeAmount="10.50"
         action="https://example.com/payment-complete">
        <Prompt for="payment-card-number">
            <Say>Please enter your credit card number.</Say>
        </Prompt>
        <Prompt for="security-code">
            <Say>Please enter the security code from your card.</Say>
        </Prompt>
    </Pay>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         transactionType="charge"
         chargeAmount="10.50"
         maxAttempts="3">
        <Prompt for="security-code" cardType="amex">
            <Say>Please enter the 4-digit security code from the front of your card.</Say>
        </Prompt>
        <Prompt for="security-code">
            <Say>Please enter the security code from your card.</Say>
        </Prompt>
        <Prompt for="payment-card-number" attempt="2 3" errorType="invalid-card-number">
            <Say>That card number was not accepted. Please try again.</Say>
        </Prompt>
    </Pay>
</Response>

<Response>
    <Pay paymentConnector="MyConnector"
         transactionType="tokenize"
         prompts='{"payment-card-number":[{"text":"Enter your card number."},{"text":"Please try again.","attempt":"2 3"}]}' />
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Pay paymentConnector="MyConnector"
         transactionType="charge"
         chargeAmount="10.50"
         parameters='{"source":"phone"}'>
        <Parameter name="order_id" value="ORD-12345" />
        <Parameter name="customer_id" value="CUST-67890" />
    </Pay>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Redirect method="POST">https://example.com/next-instructions</Redirect>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Reject reason="busy"/>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Start>
    <Stream url="wss://yourdomain.com/stream" track="both_tracks" />
  </Start>
</Response>