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.
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.