This telephone number validation web service allows you to program your web servers to initiate telephone number validation phone calls.
Explanation of service ( The term "listener" refers to the person answering the phone. )
This phone validator web service can be utilized by web masters and programmers to perform real time live telephone number validation call. The service will make up to four postings of the request to the url which you provide. The response url posted backs to your server will be in the following format:
| &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-START&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-ANSWER&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=GOODPIN&pinin=1234 &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=FINAL-HANGUP&pinin=1234 |
or you may see this sequence of responses
| &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-START&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-BUSY&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=FINAL-HANGUP&pinin= |
or you may see this sequence of responses
| &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-START&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=DIAL-ANSWER&pinin= &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=BADPIN&pinin=1233 &tvid=189&voip=&sid=123-php-session-id-456&cid=8008881234&pin=1234&phone=2812206721&status=FINAL-HANGUP&pinin=1233 |
The service is initiated using the http GET or POST methods passing all request information through POST form values or as GET url encoded parameters. To demonstrate the service we have created the form below which can be used as an example. Webmasters and programmers can use this example as a tool to fabricate and precondition the request url. Please understand the form below are the tools you can use to create the urls that you will subsequently deploy within your own applications. When you click the submit buttons below a seperate page will launch using the url that you should embed into your application.
When you sumit a request the system will respond with an telephone validator id as follows:
TVID=189
This will help you to tie all of the transactions together as well as your application specific session ids, caller ids, phone numbers and pin codes.
The service can call a phone number, and upon answering, greet the listener with a message. This message can be a voice recording of your own creation or you can elect to use our TTS voice synthesis engine. The examples below use our TTS engine. Our TTS service is fee based. You can feed your own recorded messages into this system by providing urls to the wave files you have created.
Definition of elements
account - your TV user account (use demo for testing)
phonenumber - the phone number to calland validate
pin - the digit sequence you want the listener to key back
sid - your session id which will be posted back or return to your feedback url
cid - you must provide a phone number that is verifiable. we audit these
wait - the number of second to wait for the listener to respond before hanging
up
respurl - your url to receive the results of the validation request
sndgreet - your url to a wave file to be played to the listener when they answer
the phone
sndprename - optional - your url to a wave file to be played to the listener
before the name is played
sndname - optional - our TTS engine will synthesis the name
into a wave file and play it. Form the url in the fashion
sndsuccess - your url to a wave file to be played to the listener when they
have successfully keyed the pin
sndbadpin - your url to a wave file to be played when the listener fails to
key the pin correctly
Example phone validation call request to have person key a pin into touch tone pad.