Redirect

Redirect routes the user to a different Task or URL. When redirecting to a Task, the target Task's Actions will be executed. When redirected to a URL, the Actions will be fetched from the URL and executed.

Redirecting to a URL allows you to dynamically generate the Actions JSON at any point of the dialogue. See The Autopilot Request documentation to see the parameters sent.

Example 1: Redirect to a Task

{
	"actions": [
		{
			"redirect": "task://customer-satisfaction-survey"
		}
	]
}

Redirecting to URLs

When redirecting to a URL, Redirect will make an HTTP callback to your application and will expect an Autopilot Actions JSON as a response. The request will contain all the dialogue information. This is an example of a dynamic Action since the JSON is rendered dynamically with a URL or your own endpoint.

Request Parameters

See the Autopilot Request to see the callback parameters.

Example 2: Redirect to a URL

{
    "actions": [
        {
            "redirect": {
                  "uri": "https://example.com/actions",
                  "method": "POST"
            }
        }
    ]
}

Example 3: Redirect to a Twilio Function

When redirecting to a Twilio Function, Redirect will make an HTTP callback to your application and will expect an Autopilot Actions JSON as a response. The request will contain all the dialogue information. This is also an example of a dynamic Action since the JSON is rendered dynamically with a URL or your own endpoint.

Functions provide a serverless environment for writing event-driven code using node.js to build dynamic Twilio applications. Each Function has a unique URL that can be invoked by an HTTP request to run the code.

Your Task would contain code like this:

{
    "actions": [
        {
            "redirect": {
                  "uri": "https://your-twilio-function.twil.io/actions",
                  "method": "POST"
            }
        }
    ]
}

To create a new Function in your account and point it to the uri attribute, go to the Manage Functions page in the Twilio console here. Redirecting the dialogue to a Function is recommended to dynamically respond based on input from the user.