TwiMLâ„¢ for Programmable Voice
Use this reference page to learn about Twilio TwiML instructions and verbs for managing Programmable Voice call routing and behaviors. See Related how-to documentation to learn the steps to use the info on this page.
TwiML (the Twilio Markup Language) is a set of instructions you can use to tell Twilio what to do when you receive an incoming call or SMS.
When someone makes a call to one of your Twilio numbers, Twilio looks up the URL associated with that phone number and sends it a request. Twilio then reads the TwiML instructions hosted at that URL to determine what to do, whether it's recording the call, playing a message for the caller, or prompting the caller to press digits on their keypad.
At its core, TwiML is an XML document with special tags defined by Twilio to help you build your Programmable Voice application.
Info
Not making phone calls? TwiML powers more than just Twilio Programmable Voice. For instance, check out the documentation on how to use TwiML with Programmable SMS.
The following will say "Hello, world!" when someone dials a Twilio number configured with this TwiML:
1<?xml version="1.0" encoding="UTF-8"?>2<Response>3<Say>Hello, world!</Say>4</Response>
You can always return raw TwiML from your language of choice, or leverage the Twilio SDKs to automatically create valid TwiML for you. In the code sample below, toggle to your preferred web programming language to see how the above TwiML looks using the SDK.