What is Forward
Forward will forward a call to another phone number. If the call isn't answered or the line is busy, the call is optionally forwarded to a new URL (or Twimlet). Forward optionally lets you restrict which calling phones will be forwarded.
How to Use Forward
Direct your call flow to this url:
http://twimlets.com/forward
Parameters to Send
The following parameters may/must be sent:
| Attribute Name | Allowed Values | Required? |
|---|---|---|
| PhoneNumber | Any 10 digit phone number | Y |
| CallerId | The phone number you'd like to appear as the Caller ID when forwarding. Must be a Twilio number or a verified number. | N |
| FailUrl | Any Url | N |
| Timeout | How long, in seconds, should the phone be allowed to ring. | N |
| AllowedCallers[0] | Any 10 digit phone number | N |
| AllowedCallers[1] | Any 10 digit phone number | N |
| AllowedCallers[2] | Any 10 digit phone number | N |
| AllowedCallers[3] | Any 10 digit phone number | N |
| AllowedCallers[4] | Any 10 digit phone number | N |
Example Uses
Example 1
Forward calls to 415-555-1212.
http://twimlets.com/forward?PhoneNumber=415-555-1212
Example 2
Forward calls to 415-555-1212, but if the call isn't answered or is busy, forward to a recorded greeting.
http://twimlets.com/forward?PhoneNumber=415-555-1212&FailUrl=http://myapp.com/please-try-later.mp3
Example 3
Forward calls to 415-555-1212, but only if the caller is 415-555-1212 or 510-555-1212. Other callers will hear a message that they aren't permitted to call.
http://twimlets.com/forward?PhoneNumber=415-555-1212&AllowedCallers[0]=650-555-1212&AllowedCallers[1]=510-555-1212
Try It Out!
Using our Twimlet Generator, you can build up a Twimlet URL right here: