cloudvoxcode / cloudvox-example-call-in.php
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
| #!/usr/bin/php -q |
| # Cloudvox — answer and control a phone call using PHP |
| # Place and receive phone calls via open API: http://cloudvox.com/ |
| # Learn about call scripting, Asterisk/AGI, voice apps: http://help.cloudvox.com/ |
| require ( ‘phpagi.php’ ); |
| set_time_limit( 30 ); |
| $ AGI = new AGI (); |
| $ AGI -> answer (); |
| $ AGI -> exec (» Swift «, «\» Thank you for calling Cloudvox. Enter a 6 digit number. \»»); |
| $ AGI -> exec (» Read «, ‘pin||6|skip|2|10’ ); |
| $ pin = $ AGI -> get_variable (» pin «); |
| $ AGI -> exec (» Swift «, «\» You entered . \»»); |
| $ AGI -> exec (» SayDigits «, $ pin ); |
| ?> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
| # default: off |
| # description: xinetd to accept Cloudvox connection to PHP FastAGI server |
| # more or try it: http://help.cloudvox.com/ |
| service cloudvox |
| socket_type = stream |
| type = UNLISTED |
| user = root |
| group = nobody |
| log_on_failure += USERID HOST |
| port = 4573 |
| wait = no |
| protocol = tcp |
| bind = 0.0.0.0 |
| disable = no |
| server = /full/path/to/cloudvox-example-call-in.php |
| # examples: |
| # server = /home/sally/cloudvox-example-call-in.php |
| # Note: PHP script must have correct path to PHP, and be executable (chmod +x) |
| > |
Voicent Gateway PHP Interface
The Voicent PHP class contains the following functions.
Since all these functions are implemented as a HTTP client communicating directly with Voicent Gateway, they can be run on any machine that has a connection to the host running the gateway. The php interface source code is included at the end of this section.
Work with Interactive Applications
For many applications, it is desirable to get responses from callees in addition to deliver a message. The interaction can be implemented by using the low level gateway VoiceXML interface. However, using the low level API is a time consuming and error prone task. A better solution is to utilize Voicent IVR Studio to create an interactive application, and use the extended Simple Call Interface to trigger a phone call.
Make a phone call and play the specified text message. The text message is convert to voice by Voicent Gateway’s text-to-speech engine.
The options are:
| The phone number to call | |
| The message for the phone call | |
| Ask the gateway to automatically delete the call request after the call is made if it is set to ‘1’ |
The return value is the call request id .
call_text(«123-4567″, «Hello, how are you doing», 1);
Make a call to phone number ‘123-4567’ and say ‘Hello, how are you doing’. Since the selfdelete bit is set, the call request record in the gateway will be removed automatically after the call.
$reqId = call_text(«123-4567″, «Hello, how are you doing», 0);
Make a call to phone number ‘123-4567’ and say ‘Hello, how are you doing’. Since the selfdelete bit is not set, the call request record in the gateway will not be removed after the call. You can then use call_status to get the call status, or use call_remove to remove the call record.
Make a phone call and play the specified audio message.
The options are:
| The phone number to call | |
| The audio message for the phone call. The format must be PCM 16bit, 8KHz, mono wave file. The audio file must be on the same host as Voicent Gateway. | |
| Ask the gateway to automatically delete the call request after the call is made if it is set to ‘1’ |
The return value is the call request id .
call_audio(«123-4567″, «C:\my audios\hello.wav», 1);
Make a call to phone number ‘123-4567’ and play the hello.wav file. Since the selfdelete bit is set, the call request record in the gateway will be removed automatically after the call.
$reqId = call_audio(«123-4567″, «C:\my audios\hello.wav», 0);
Make a call to phone number ‘123-4567’ and play the hello.wav file. Since the selfdelete bit is not set, the call request record in the gateway will not be removed after the call. You can then use call_status to get the call status, or use call_remove to remove the call record.
Check the call status of the call with . If the call is made, the return value is ‘Call Made’ , or if the call is failed, the return value is ‘Call Failed’ , and for any other status, the return value is «» .
Please note that an empty string is returned if the call is still in progress. You’ll need to wait and then poll the status again.
$status = call_status(«11234035434″);
Remove the call record of the call with . If the call is not made yet, it will be removed also.
call_remove(«11234035434″);
Keep calling a list of people until anyone enters the confirmation code. The message is the specified audio file. This is ideal for using it in a phone notification escalation process.
To use this feature, Voicent BroadcastByPhone Professional version has to be installed. This function is similar to the command line interface BroadcastByPhone has. But since the command cannot be invoke over a remote machine, this perl function uses the gateway to schedule an event, which in turn invokes the command on the gateway host.
| The BroadcastByPhone program. It is usually ‘C:\Program Files\Voicent\BroadcastByPhone\bin\vcast’ on the gateway host. | |
| The BroadcastByPhone call list to use. | |
| The confirmation code use for the broadcast | |
| The audio file to use for the broadcast |
call_till_confirm(
«C:\Program Files\Voicent\BroadcastByPhone\bin\vcast.exe»,
«C:\My calllist\escalation.voc»,
«911911»,
«C:\My calllist\escalation.wav»);
This will invoke BroadcastByPhone program on the gateway host and start calling everyone one the call list defined in ‘C:\My calllist\escalation.voc’ . The audio message played is ‘C:\My calllist\escalation.wav’ . And as soon as anyone on the list enters the confirmation code ‘911911’ , the call will stop automatically.
Source Code
class Voicent
var $host = «localhost»;
var $port = 8155;
function _call_now($body)
$headers = «POST /ocall/callreqHandler.jsp HTTP/1.1\r\n» .
«User-Agent: Mozilla/4.0\r\n» .
«Host: » . $this->host . «\r\n» .
«Content-Type: application/x-www-form-urlencoded\r\n» .
«Content-Length: » . strlen($body) . «\r\n» .
«\r\n»;
if (! ($sock = fsockopen($this->host, $this->port, $errno, $errstr))) echo $errstr;
return false;
>
fwrite($sock, $headers.$body, strlen($headers.$body));
$reqid = «»;
while ($line = fgets($sock, 4096)) if (preg_match(«/\[ReqId=(.*)\]/», $line, $matches)) $reqid = $matches[1];
break;
>
>
function call_text($phoneno, $textmsg, $selfdelete)
$body = «info=» . urlencode(«call » . $phoneno) . «&»;
$body .= «phoneno=» . urlencode($phoneno) . «&»;
$body .= «firstocc=10&»;
$body .= «txt=» . urlencode($textmsg) . «&»;
$body .= «selfdelete=» . $selfdelete;
function call_audio($phoneno, $audiofile, $selfdelete)
$body = «info=» . urlencode(«call » . $phoneno) . «&»;
$body .= «phoneno=» . urlencode($phoneno) . «&»;
$body .= «firstocc=10&»;
$body .= «audiofile=» . urlencode($audiofile) . «&»;
$body .= «selfdelete=» . $selfdelete;
function call_status($reqId)
$headers = «GET /ocall/callstatusHandler.jsp?reqid=» . $reqId . » HTTP/1.1\r\n» .
«User-Agent: Mozilla/4.0\r\n» .
«Host: » . $this->host . «\r\n» .
«\r\n»;
if (! ($sock = fsockopen($this->host, $this->port, $errno, $errstr))) echo $errstr;
return false;
>
fwrite($sock, $headers, strlen($headers));
$status = «»;
while ($line = fgets($sock, 4096)) if (preg_match(«/\^made\^/», $line)) $status = «Call Make»;
break;
>
if (preg_match(«/\^failed\^/», $line)) $status = «Call Failed»;
break;
>
>
function call_remove($reqId)
$headers = «GET /ocall/callremoveHandler.jsp?reqid=» . $reqId . » HTTP/1.1\r\n» .
«User-Agent: Mozilla/4.0\r\n» .
«Host: » . $this->host . «\r\n» .
«\r\n»;
if (! ($sock = fsockopen($this->host, $this->port, $errno, $errstr))) echo $errstr;
return false;
>
fwrite($sock, $headers, strlen($headers));
function call_till_confirm($vcast, $voc, $confirmcode, $wavefile)
$body = «info=» . urlencode(«call till confirm») . «&»;
$body .= «phoneno=0000000» . «&»;
$body .= «firstocc=10&»;
$body .= «startexec=» . urlencode($vcast) . «&»;
$body .= «selfdelete=» . $selfdelete . «&»;
$cmdline = «\»» . $voc . «\» -startnow -confirmcode » . $confirmcode;
$cmdline .= » -wavfile \»» . $wavefile . «\»»;
$body .= «cmdline=» . urlencode($cmdline);
# $voicent = new Voicent;
# $id = $voicent->call_text(«1234567», «hello, how are you», «0»);
# print $id;
# $id = $voicent->call_audio(«1234567», «C:\Temp\welcome.wav», 0);
# print $id;
# print $voicent->call_status(«1103704332609»);
# $voicent->call_remove(«1103704332609»);
# print $voicent->call_status(«1103704332609»);
Make Outbound Phone Calls with PHP
Twilio is launching a new Console. Some screenshots on this page may show the Legacy Console and therefore may no longer be accurate. We are working to update all screenshots to reflect the new Console experience. Learn more about the new Console.
In this guide, we’ll show you how to use Programmable Voice to make outbound phone calls from your PHP applications. It’s pretty easy — all you’ll need is the Twilio library for PHP , a voice-capable Twilio phone number, your account credentials, and five minutes to have a boatload of fun at your keyboard. Let’s get started!
Purchase a voice-enabled Twilio phone number
In the Twilio console, search for and purchase an available phone number capable of making outbound calls. You’ll use this phone number as the «From» phone number when you initiate an outbound call.
Retrieve your Twilio account credentials
First, you’ll need to get your Twilio account credentials. They consist of your AccountSid and your Auth Token. They can be found on the home page of the console.
Make an outbound call
Now we’re ready to make an outbound call with the Twilio PHP library.