Menu

Expand
Rate this page:

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.

A maximum of 5 redirects is supported for any single request.

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.

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.

Loading Code Sample...
        
        
        

        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!

        thanks-feedback-gif