Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Create Tasks from Phone Calls using TwiML: Receive an Incoming Call

We've seen how to create Tasks using the TaskRouter REST API and how to accept a Task Reservation using both the REST API and Assignment Callback instructions. TaskRouter also introduces new TwiML instructions that you can use to create a Task from a Twilio phone call.

To receive an incoming phone call, we first need a Twilio phone number. In this example we'll use a US toll-free number, but you can use a Voice capable number from any country.

Before purchasing or setting up the phone number, we need to create a PHP file to handle incoming calls. Create a new file called 'incoming-call.php' and add the code below.

header("Content-Type: application/xml; charset=utf-8");

  <Gather action="enqueue-call.php" numDigits="1" timeout="5">
    <Say language="es">Para Español oprime el uno.</Say>
    <Say language="en">For English, please hold or press two.</Say>

You can use the Buy Numbers section of the Twilio Voice and Messaging web portal to purchase a new phone number, or use an existing Twilio phone number. Open the phone number details page and point the Voice Request URL at your new incoming-call.php file:

Using any phone, call the Twilio number. You will be prompted to press one for Spanish or two for English. However, when you press a digit, you'll hear an error message. That's because our <Gather> verb is pointing to a second PHP file, 'enqueue-call.php', which we haven't implemented yet. In the next step we'll add the required file and use it to create a new Task based on the language selected by the caller.

Next: Create a Task using Enqueue »

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.