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:

Open Source

Twimlets are open sourced, you are free to download, modify and run the code on your own server. View the Source.

Note: Uses the Open Source Twilio PHP library available on GitHub.