Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Page tools
Useful for sharing or LLM
Accelerate development with AI
On this page
Looking for more inspiration?Visit the

Creating Tasks and Accepting Reservations: Accept a Reservation using Assignment Callback Instructions

To accept a Reservation automatically, return an accept assignment instruction in a synchronous HTTP response from your server when TaskRouter notifies it. In the previous step, you created a Task and accepted it using the Reservations subresource of the REST API. This time, you create another Task with the REST API and have your server accept the Reservation as soon as it is notified.

Before we create the next Task, once again make sure that our Worker Alice is in a non-available Activity state.

Call the Create Task endpoint exposed with Program.cs again, or execute the following curl command:

Create a TaskLink to code sample: Create a Task
1
ATTRIBUTES_OBJ=$(cat << EOF

2
{

3
  "selected_language": "es"

4
}

5
EOF

6
)

7
curl -X POST "https://taskrouter.twilio.com/v1/Workspaces/WSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Tasks" \

8
--data-urlencode "Attributes=$ATTRIBUTES_OBJ" \

9
--data-urlencode "WorkflowSid=WWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \

10
-u $TWILIO_API_KEY:$TWILIO_API_SECRET

This time, before bringing Alice online, we need to make changes to our assignment_callback method in our Program.cs. Open it and modify the existing code to reflect the following:

Program.cs

programcs page anchor
1
using System;

2
using System.Net;

3
using SimpleWebServer;

4
using Twilio;

5
using Twilio.Rest.Taskrouter.V1.Workspace.Task;

6


7
namespace taskroutercsharp

8
{

9
    class MainClass

10
    {

11
        // Find your Account SID: https://www.twilio.com/console

12
        // Create API keys: https://www.twilio.com/docs/iam/api-keys/keys-in-console

13
        const string AccountSid = "{{ account_sid }}";

14
        const string ApiKey = "{{ api_key }}";

15
        const string ApiSecret = "{{ api_secret }}";

16
        const string WorkspaceSid = "{{ workspace_sid }}";

17
        const string WorkflowSid = "{{ workflow_sid }}";

18


19
        public static void Main (string[] args)

20
        {

21
            TwilioClient.Init(ApiKey, ApiSecret, AccountSid);

22
            WebServer ws = new WebServer (SendResponse, "http://localhost:8080/");

23
            ws.Run ();

24
            Console.WriteLine ("A simple webserver. Press a key to quit.");

25
            Console.ReadKey ();

26
            ws.Stop ();

27
        }

28


29
        public static HttpListenerResponse SendResponse(HttpListenerContext ctx)

30
        {

31
            HttpListenerRequest request = ctx.Request;

32
            HttpListenerResponse response = ctx.Response;

33


34
            String endpoint = request.RawUrl;

35


36
            if (endpoint.EndsWith("assignment_callback")) {

37
                response.StatusCode = (int) HttpStatusCode.OK;

38
                response.ContentType = "application/json";

39
                response.StatusDescription = "{\"instruction\":\"accept\"}";

40
                return response;

41
            } else if (endpoint.EndsWith ("create_task")) {

42
                response.StatusCode = (int)HttpStatusCode.OK;

43
                response.ContentType = "application/json";

44
                var task = TaskResource.Create(

45
                    WorkspaceSid, attributes: "{\"selected_language\":\"es\"}", workflowSid: WorkflowSid);

46
                response.StatusDescription = task.Attributes;

47
                return response;

48
            } else if (endpoint.EndsWith ("accept_reservation")) {

49
                response.StatusCode = (int)HttpStatusCode.OK;

50
                response.ContentType = "application/json";

51
                var taskSid = request.QueryString ["TaskSid"];

52
                var reservationSid = request.QueryString ["ReservationSid"];

53
                var reservation = ReservationResource.Update(

54
                    WorkspaceSid, taskSid, reservationSid,

55
                    ReservationResource.StatusEnum.Accepted);

56
                response.StatusDescription = "{\"reservation_status\":\"" + reservation.ReservationStatus + "\"}";

57
                return response;

58
            }

59
            response.StatusCode = (int) HttpStatusCode.OK;

60
            return response;

61
        }

62
    }

63
}

Instead of returning an empty JSON document as before, we've included an 'assignment instruction' in our response. The 'accept' assignment instruction tells TaskRouter to automatically accept the Reservation and assign the Task to the Worker it has been reserved for.

To kick this process off, we need to transition Alice to an available Activity. With your Workspace open in the TaskRouter web portal(link takes you to an external page), click 'Workers' then click to edit Alice and set her Activity to 'Idle'.

Now, click 'Tasks' in the main navigation and you should see that the Task has an Assignment Status of 'assigned':

Task in Customer Care Requests queue assigned with priority 1 and age 128.

What actually happened is that Alice was reserved for a very short period of time. TaskRouter made a request to your web server at the Assignment Callback URL, and your server told TaskRouter to accept the Reservation. At that point, Alice's Activity transitioned to the 'Assignment Activity' of the TaskQueue that assigned the Task, as it did in the previous step.

Alice's status is Busy and not available as of 00:21:22 EST on 2015-02-11.

And that's that. We created another Task using the REST API, accepted it via an assignment instruction at our Workflow's Assignment Callback URL and saw that this immediately accepted the Reservation for our Worker.

Onward! Next we learn about shortcuts to create Tasks originating from Twilio phone calls.

Part 3: Create Tasks from Phone Calls using TwiML »