Page History

Overview

Overview

FacebookCallMe FacebookCallMe is an App written in PHP which allows anyone to place a call with a Facebook App using using the UnifiedAPI of VoipNow 3.

It uses the PhoneCall resource exposed by UnifiedAPI and the following requests:

• Create PhoneCall -  Creates Creates phone calls using any given source and destination
• List PhoneCall - Fetches the list of phone calls that are in the system at a particular point in time

...

In order to be able to use the FacebookCallMe App, your system needs PHP 5.2 3 or higher and a Web a web server (Apache2Apache 2, nginx, lighttpd, etc). Also, your Your VoipNow server must be at least version 3.0.0.

STEP 1:  Download the files.Download the archive, extract the files, and copy them to a Switch to the directory that can be accessed over the Web (where your web server resides).web (e.g /var/www/html) and clone the Git repository:

STEP 2:  Proceed to allowing permissions and ownership rights.

You also need to give proper permissions and ownership to the files of the plugin - the plugin needs to be owned by the web server user and group.

For example, if we use httpd as a webserver:

...

chmod -R 755 <PATH_TO_FacebookCallMe>

...

chown -R httpd:httpd <PATH_TO_FacebookCallMe>

STEP 3:  Configure the App.

To be able to use the App, you must configure it. To do so, open the file file config.php in the  in the <PATH_TO_FacebookCallMe>/interface/plibconfig/config.php and and change the following settings:

Behavior

User Interface Interface

As soon as the setup process is complete, you can access the interface through the Facebook App. To do so, simply visit visit https://<IP>/<PATH_TO_FacebookCallMe>/interface/. The page displays an input field with a button.

...

Enter a valid phone number and press call. The status of the call is displayed is displayed in this box. Errors are displayed as well. For a list of error messages, check the UnifiedAPI manual.

...

Once the request has been made, if no error occurrederror occurred, a JSON encoded response is returned. It contains a link to the newly created call. Check the example at the the Create PhoneCalls page page.

The HTTP Request to make a call looks as shown below: 

POST /uapi/phoneCalls/@me/simple HTTP/1.1
HOST x.x.x.x
Content Type: application/json
Authorization: <OAUTH_ACCESS_TOKEN>
  
{
  "extension":"<VN_EXTENSION>",
  "phoneCallView":[
    {
       "source":["<VN_EXTENSION>"],
       "destination":["8887777"]
       "callerId":"Facebook CallMe <8887777>"
    }
  ]
}

List the Phone Call

Every 5 seconds, the javascript Every 5 seconds, the javascript (lib.js)  makes a request for information about the call. Such information is obtained through a UnifiedAPI request makes a request for information about the call. Such information is obtained through a UnifiedAPI request using the List PhoneCalls resource.

$request = new cURLRequest();
$request->setMethod(cURLRequest::METHOD_GET);
$request->setHeaders(array(
	'Content-type' => 'application/json',
	'Authorization' => $config['OAUTH_ACCESS_TOKEN']
));
$response = $request->sendRequest($url);

The The HTTP Request to retrieve a call looks as shown below:

...