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.

Receive an Incoming 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 add on to our Program.cs to handle incoming calls:

Program.cs

1using System;
2using System.Net;
3using SimpleWebServer;
4using Twilio;
5using Twilio.Rest.Taskrouter.V1.Workspace;
6using Twilio.Rest.Taskrouter.V1.Workspace.Task;
7using Twilio.TwiML;
8
9namespace taskroutercsharp
10{
11    class MainClass
12    {
13        // Find your Account SID at twilio.com/console
14        // Provision API Keys at twilio.com/console/runtime/api-keys
15        const string AccountSid = "{{ account_sid }}";
16        const string ApiKey = "{{ api_key }}";
17        const string ApiSecret = "{{ api_secret }}";
18        const string WorkspaceSid = "{{ workspace_sid }}";
19        const string WorkflowSid = "{{ workflow_sid }}";
20
21        public static void Main(string[] args)
22        {
23            // Initialize the Twilio client
24            TwilioClient.Init(ApiKey, ApiSecret, AccountSid);
25
26            WebServer ws = new WebServer(SendResponse, "http://localhost:8080/");
27            ws.Run();
28            Console.WriteLine("A simple webserver. Press a key to quit.");
29            Console.ReadKey();
30            ws.Stop();
31        }
32
33        public static HttpListenerResponse SendResponse(HttpListenerContext ctx)
34        {
35            HttpListenerRequest request = ctx.Request;
36            HttpListenerResponse response = ctx.Response;
37
38            String endpoint = request.RawUrl;
39
40            if (endpoint.EndsWith("assignment_callback"))
41            {
42                response.StatusCode = (int)HttpStatusCode.OK;
43                response.ContentType = "application/json";
44                response.StatusDescription = "{\"instruction\":\"accept\"}";
45                return response;
46            }
47            else if (endpoint.EndsWith("create_task"))
48            {
49                response.StatusCode = (int)HttpStatusCode.OK;
50                response.ContentType = "application/json";
51                TaskResource task = TaskResource.Create(
52                    WorkspaceSid,
53                    attributes: "{\"selected_language\":\"es\"}",
54                    workflowSid: WorkflowSid);
55
56                response.StatusDescription = task.Attributes;
57                return response;
58            }
59            else if (endpoint.EndsWith("accept_reservation"))
60            {
61                response.StatusCode = (int)HttpStatusCode.OK;
62                response.ContentType = "application/json";
63                var taskSid = request.QueryString["TaskSid"];
64                var reservationSid = request.QueryString["ReservationSid"];
65                ReservationResource reservation = ReservationResource.Update(
66                    WorkspaceSid,
67                    taskSid,
68                    reservationSid,
69                    ReservationResource.StatusEnum.Accepted);
70
71                response.StatusDescription = "{\"reservation_status\":\"" + reservation.ReservationStatus + "\"}";
72                return response;
73            }
74            else if (endpoint.EndsWith("incoming_call"))
75            {
76                response.StatusCode = (int)HttpStatusCode.OK;
77                response.ContentType = "application/xml";
78                var twiml = new VoiceResponse();
79                twiml.Gather(new Gather(numDigits: 1, action: "enqueue_call")
80                    .Say("Para Espanol oprima el uno.", language: "es" )
81                    .Say("For English, please hold or press two.", language: "en"));
82
83                response.StatusDescription = twiml.ToString();
84                return response;
85            }
86            response.StatusCode = (int)HttpStatusCode.OK;
87            return response;
88        }
89    }
90}

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 endpoint:

TaskRouter Quickstart showing phone number properties and request URLs for voice and messaging.

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 another endpoint, enqueue_call, which we haven't implemented yet. In the next step we'll add the required endpoint and use it to create a new Task based on the language selected by the caller.

Next: Create a Task using Enqueue »