TwiML Redirect

Description:

TwiML Redirect allows you to redirect a Voice Call to be handled outside of Studio and optionally return control back to Studio.

Note that your TwiML can be hosted and served in many ways, including and not limited to:

• As a static asset served by your own server
• As a Serverless Asset
• In a TwiML Bin (supports mustache templates)
• As the result of calling a Serverless Function

Passing Parameters to the TwiML Redirect URL

If you want to pass parameters to the TwiML Redirect URL from your Studio Flow, you can pass them in the query string, as part of the URL.

For example, if you wanted to pass the Digits variable from the Gather widget, you would enter the following in the URL field for the TwiML Redirect widget:

https://example.com/myfunction?Digits={{widgets.MY_WIDGET_NAME.Digits}}

Returning Control to Studio

To handle returning control to Studio, you need to specify a <Redirect> to the Studio Webhook URL and append ?FlowEvent=return. Any additional parameters specified in the return URL will be injected into the Studio context and addressable via Liquid template variables.

Example:

<Response>
  <Say>Returning you back to the Studio Flow.</Say>
  <Redirect>https://webhooks.twilio.com/v1/Accounts/{AccountSid}/Flows/{FlowSid}?FlowEvent=return&foo=bar</Redirect>
</Response>

The URL parameter foo illustrated above will be passed automatically into your Flow and can be referenced via Liquid as {{widgets.your_redirect_widget_name.foo}}.

Tip: To retrieve the Studio Webhook URL, in your Studio flow, click the red Trigger widget. The URL starting with https://webhooks.twilio.com/v1/... is the Webhook URL.

Required Configuration:

Optional Configuration:

Transitions:

These are the events that trigger transitions from this widget: