What is Find Me

Find me will ring up to 10 phone numbers in order, until somebody answers the call. If nobody answers, then the call is optionally forwarded to a new URL (or Twimlet).

How to Use Find Me

Direct your call flow to this url:

http://twimlets.com/findme

Parameters to Send

The following parameters may/must be sent:

Attribute Name Allowed Values Required?
PhoneNumbers[0] Any 10 digit phone number Y
PhoneNumbers[1] Any 10 digit phone number N
PhoneNumbers[2] Any 10 digit phone number N
PhoneNumbers[3] Any 10 digit phone number N
PhoneNumbers[4] Any 10 digit phone number N
PhoneNumbers[5] Any 10 digit phone number N
PhoneNumbers[6] Any 10 digit phone number N
PhoneNumbers[7] Any 10 digit phone number N
PhoneNumbers[8] Any 10 digit phone number N
PhoneNumbers[9] Any 10 digit phone number N
FailUrl Any Url N
Message A URL or a string to play or read to the person who answers the second leg of the phone call. It should tell them to press any key to accept the call. If not provided, a default message will be played. N
Timeout How long, in seconds, should the phone be allowed to ring. N

Example Uses

Example 1

Try to reach me at 415-555-1212, 415-555-1313 and 415-555-1414.

http://twimlets.com/findme?PhoneNumbers[0]=415-555-1212&PhoneNumbers[1]=415-555-1313&PhoneNumbers[2]=415-555-1414

Example 2

Try to reach me at 415-555-1212, 415-555-1313 and 415-555-1414, but if nobody answers, forward to a recorded greeting.

http://twimlets.com/findme?PhoneNumbers[0]=415-555-1212&PhoneNumbers[1]=415-555-1313&PhoneNumbers[2]=415-555-1414&FailUrl=http://myapp.com/please-try-later.mp3

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 TwilioResponse PHP library available on GitHub.