The <Redirect> verb transfers control of a call 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.
Use it in a <Redirect> verb like so:
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.redirect({
method: 'POST'
}, 'http://pigeons.com/twiml.xml');
console.log(response.toString());
using Twilio.TwiML;
using Twilio.Http;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Redirect(new Uri("http://pigeons.com/twiml.xml"), method: HttpMethod.Post);
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->redirect('http://pigeons.com/twiml.xml', ['method' => 'POST']);
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.redirect('http://pigeons.com/twiml.xml', method: 'POST')
puts response
from twilio.twiml.voice_response import Redirect, VoiceResponse
response = VoiceResponse()
response.redirect('http://pigeons.com/twiml.xml', method='POST')
print(response)
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
import com.twilio.http.HttpMethod;
public class Example {
public static void main(String[] args) {
Redirect redirect = new Redirect.Builder("http://pigeons.com/twiml.xml").method(HttpMethod.POST)
.build();
VoiceResponse response = new VoiceResponse.Builder().redirect(redirect)
.build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect method="POST">http://pigeons.com/twiml.xml</Redirect>
</Response>
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 after a <Dial>
verb with no URL. When the <Dial> verb finishes, the
<Redirect> executes. <Redirect> makes a request to http://www.foo.com/nextInstructions and
transfers the call flow to the TwiML received in response to that request.
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.dial('415-123-4567');
response.redirect('http://www.foo.com/nextInstructions');
console.log(response.toString());
using Twilio.TwiML;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Dial("415-123-4567");
response.Redirect(new Uri("http://www.foo.com/nextInstructions"));
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->dial('415-123-4567');
$response->redirect('http://www.foo.com/nextInstructions');
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.dial(number: '415-123-4567')
response.redirect('http://www.foo.com/nextInstructions')
puts response
from twilio.twiml.voice_response import Dial, Redirect, VoiceResponse
response = VoiceResponse()
response.dial('415-123-4567')
response.redirect('http://www.foo.com/nextInstructions')
print(response)
import com.twilio.twiml.voice.Dial;
import com.twilio.twiml.voice.Number;
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
public class Example {
public static void main(String[] args) {
Number number = new Number.Builder("415-123-4567").build();
Dial dial = new Dial.Builder().number(number).build();
Redirect redirect = new Redirect.Builder("http://www.foo.com/nextInstructions")
.build();
VoiceResponse response = new VoiceResponse.Builder().dial(dial)
.redirect(redirect).build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Dial>415-123-4567</Dial>
<Redirect>http://www.foo.com/nextInstructions</Redirect>
</Response>
Redirects call flow control to the TwiML at a URL relative to the current URL.
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.redirect('../nextInstructions');
console.log(response.toString());
using Twilio.TwiML;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Redirect(new Uri("../nextInstructions"));
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->redirect('../nextInstructions');
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.redirect('../nextInstructions')
puts response
from twilio.twiml.voice_response import Redirect, VoiceResponse
response = VoiceResponse()
response.redirect('../nextInstructions')
print(response)
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
public class Example {
public static void main(String[] args) {
Redirect redirect = new Redirect.Builder("../nextInstructions")
.build();
VoiceResponse response = new VoiceResponse.Builder().redirect(redirect)
.build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect>../nextInstructions</Redirect>
</Response>
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.redirect({
method: 'POST'
}, 'http://pigeons.com/twiml.xml');
console.log(response.toString());
using Twilio.TwiML;
using Twilio.Http;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Redirect(new Uri("http://pigeons.com/twiml.xml"), method: HttpMethod.Post);
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->redirect('http://pigeons.com/twiml.xml', ['method' => 'POST']);
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.redirect('http://pigeons.com/twiml.xml', method: 'POST')
puts response
from twilio.twiml.voice_response import Redirect, VoiceResponse
response = VoiceResponse()
response.redirect('http://pigeons.com/twiml.xml', method='POST')
print(response)
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
import com.twilio.http.HttpMethod;
public class Example {
public static void main(String[] args) {
Redirect redirect = new Redirect.Builder("http://pigeons.com/twiml.xml").method(HttpMethod.POST)
.build();
VoiceResponse response = new VoiceResponse.Builder().redirect(redirect)
.build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect method="POST">http://pigeons.com/twiml.xml</Redirect>
</Response>
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.dial('415-123-4567');
response.redirect('http://www.foo.com/nextInstructions');
console.log(response.toString());
using Twilio.TwiML;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Dial("415-123-4567");
response.Redirect(new Uri("http://www.foo.com/nextInstructions"));
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->dial('415-123-4567');
$response->redirect('http://www.foo.com/nextInstructions');
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.dial(number: '415-123-4567')
response.redirect('http://www.foo.com/nextInstructions')
puts response
from twilio.twiml.voice_response import Dial, Redirect, VoiceResponse
response = VoiceResponse()
response.dial('415-123-4567')
response.redirect('http://www.foo.com/nextInstructions')
print(response)
import com.twilio.twiml.voice.Dial;
import com.twilio.twiml.voice.Number;
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
public class Example {
public static void main(String[] args) {
Number number = new Number.Builder("415-123-4567").build();
Dial dial = new Dial.Builder().number(number).build();
Redirect redirect = new Redirect.Builder("http://www.foo.com/nextInstructions")
.build();
VoiceResponse response = new VoiceResponse.Builder().dial(dial)
.redirect(redirect).build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Dial>415-123-4567</Dial>
<Redirect>http://www.foo.com/nextInstructions</Redirect>
</Response>
const VoiceResponse = require('twilio').twiml.VoiceResponse;
const response = new VoiceResponse();
response.redirect('../nextInstructions');
console.log(response.toString());
using Twilio.TwiML;
using System;
class Example
{
static void Main()
{
var response = new VoiceResponse();
response.Redirect(new Uri("../nextInstructions"));
Console.WriteLine(response.ToString());;
}
}
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML;
$response = new TwiML();
$response->redirect('../nextInstructions');
echo $response;
require 'twilio-ruby'
response = Twilio::TwiML::VoiceResponse.new
response.redirect('../nextInstructions')
puts response
from twilio.twiml.voice_response import Redirect, VoiceResponse
response = VoiceResponse()
response.redirect('../nextInstructions')
print(response)
import com.twilio.twiml.voice.Redirect;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;
public class Example {
public static void main(String[] args) {
Redirect redirect = new Redirect.Builder("../nextInstructions")
.build();
VoiceResponse response = new VoiceResponse.Builder().redirect(redirect)
.build();
try {
System.out.println(response.toXml());
} catch (TwiMLException e) {
e.printStackTrace();
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect>../nextInstructions</Redirect>
</Response>