The <Redirect>
verb transfers control of a Message response to the TwiML at a different URL. All verbs after <Redirect>
are unreachable and ignored.
The <Redirect>
verb supports the following attributes that modify its behavior:
Attribute Name | Allowed Values | Default Value |
---|---|---|
method | GET , POST | POST |
The 'method' attribute takes the value GET
or POST
. This tells Twilio whether to request the <Redirect>
URL via HTTP GET
or POST
. POST
is the default.
The "noun" of a TwiML verb is the stuff nested within the verb that's not a verb itself; it's the stuff the verb acts upon. These are the nouns for <Redirect>
:
Noun | TwiML Interpretation |
---|---|
plain text | An absolute or relative URL for a different TwiML document. |
No verbs can be nested within <Redirect>
and <Redirect>
can't be nested in any other verbs.
In this example, we have a <Redirect>
verb. <Redirect>
makes a request to http://www.foo.com/nextInstructions
and transfers control to the TwiML returned from that request.
1const MessagingResponse = require('twilio').twiml.MessagingResponse;23const response = new MessagingResponse();4response.redirect('http://www.example.com/nextInstructions');56console.log(response.toString());
1<?xml version="1.0" encoding="UTF-8"?>2<Response>3<Redirect>4http://www.example.com/nextInstructions5</Redirect>6</Response>
Redirects flow control to a TwiML at a URL relative to the current URL.
1const MessagingResponse = require('twilio').twiml.MessagingResponse;23const response = new MessagingResponse();4response.redirect('../nextInstructions');56console.log(response.toString());
1<?xml version="1.0" encoding="UTF-8"?>2<Response>3<Redirect>4../nextInstructions5</Redirect>6</Response>