Initiating Calls via HTTP Requests

One of the fun things I do on the regular hosted Voxeo servers is initiate outbound calls to a list of telephone numbers. I do this by sending a HTTP requests to the Voxeo server. In other words, I don't need to make a call to the server to start my script running.

It's nice to know that I can do the same thing on P2006. To trigger a script on the P2006 platform, send an HTTP request in the following format:

http://[ip of server]:9999/CCXML.start?tokenid=[route id]

where "route id" is the "dialed ID" that's in the call route definition. For example, if I have a CallXML-script entry in my routing table:

<category name="route13">
<item name="dialedID">outxml</item>
<item name="URL">http://127.0.0.1:9990/outdial.xml</item>
<item name="ppid">5061</item>
</category>

then I would use the URL
http://[ip of server]:9999/CallXML.start?tokenid=outxml

Note that calls to scripts that use Voxeo's version of CCXML use "CCXML.start" in the URL, calls to W3C-compliant scripts use CCXML10.start, and CallXML scripts are started with "CallXML.start" in the URL. VoiceXML scripts can't be triggered directly (just as with Voxeo's regular servers). To get them started, call a CCXML script and use <dialogstart>.

To send additional data to the script, append "&x=value" to the URL as needed. It's a nice way to have event-driven outbound calling. ("It's 3:25 PM. You have an appointment in 25 minutes at the doctor's office.")

A short thread on this subject is available at the Voxeo forum.

This page explains how to get the script to run via an HTTP request. To learn how to initiate the actual outbound call from within he script, see the "SIP" section of this how-to guide.