Rate this page:

The Autopilot Request

When a Task is triggered, Autopilot makes a request to the URL configured on the Task that will always include the parameters listed below. Autopilot also makes the same request if the dialogue is redirected to another Task using the Redirect Action or sent to a human using the Handoff Action.

For each request, Autopilot expects a valid Actions JSON in your response. For example, you might respond with:

// A potential response to the Autopilot request, which would SAY hello before listening for further input.

    "actions": [
	    "say": "Hi there! I'm Jaimie your new Assistant. How can I help you?"
	    "listen": true

Autopilot will send these parameters either as POST parameters, in the format application/x-www-form-urlencoded, or URL query parameters, depending on which HTTP method you've configured.

Parameter Description Example
AccountSid Your Twilio account ID. It is 34 characters long, and always starts with the letters AC. ACXXXXX
AssistantSid The Autopilot assistant ID. It is 34 characters long, and always starts with UA. UAXXXXX
DialogueSid The session identifier. It is 34 characters long, and always starts with the letters UK. UKXXXXX
UserIdentifier The unique user identifier coming from the channel. For Voice and SMS it will be the user's phone number. +18304765664
CurrentInput The last thing the user said. "I want to change my appointment"
CurrentTask The user's current task. change_appointments
Field_{field-name}_Value The key-value pair of the field value recognized. A different key-value pair will be sent for each field value. Field_CLAIM_NUMBER_Value
Field_{field-name}_Type The key-value pair of the field type recognized. A different key-value pair will be sent for each field type. Twilio.ALPHANUMERIC
DialoguePayloadUrl A URL to the Dialogue JSON payload that contains the context and data collected during the Autopilot session.

A JSON Payload that contains all the Autopilot memory values.

NOTE: Memory is only sent in POST requests to prevent query params from getting truncated.

  "collected_data": {
    "get_insurance": {
         "answers": {
            "car_model": {
               "answer": "3 Series",
               "filled": true,
               "confirmed": false,
               "attempts": 1
             "car_year": {
               "answer": "2016",
               "filled": true,
               "type": "Twilio.NUMBER",
               "confirmed": false,
               "attempts": 1
             "car_make": {
               "answer": "It's a BMW",
               "filled": true,
               "confirmed": false,
               "attempts": 1
             "car_state": {
               "answer": "California",
               "type": "Twilio.US_STATE",
               "filled": true,
               "attempts": 3,
               "confirmed": false
    "date_completed": "",
    "date_started": "2019-08-03T00:13:18Z",
    "status": "in-progress"

The channel the interaction is taking place.


CurrentTaskConfidence The confidence score for the task detected. It can take values from 0.00 to 1.00, and fallback will only occur when the confidence is null/not set. 0.7
NextBestTask The task with the next highest confidence score cancel_appointment
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 by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more