Audio conference service implementation using VoxImplant
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Audio conferencing service

Conference Manager Interface

This project contains VoxEngine scenarios, webservice (PHP), DB schema (MySQL) and web interface for conference management. This README file describes how to use the provided files to build audio conferencing service. The only thing you need to start building your audio conferencing is VoxImplant developer account - you can get it for free at


Webservice Installation

Use voximplant.sql from DB_schema to create database structure, in addition to the structure there will be one user admin/admin created in the managers table.

Upload files from Webservice folder on your web server (with PHP support) and change database connection settings in shim.php file:

// MySQL DB connection configuration
`$config = array();
$config["hostname"]  = "";
$config["database"]  = "voxconf";
$config["username"]  = "root";
$config["password"]  = "";

And specify your VoxImplant API access settings (you can get this info at and rule id will be generated automatically later - see VoxImplant Setup):

*   VoxImplant HTTP API access settings
define("API_URL", "");
define("RULE_ID", "YOUR APPLICATION RULE_ID"); // Rule which starts conference via HTTP request

You can also specify your SMTP server info in sendEmail function if you plan to send email notifications with conference access info to participants and uncomment this string to enable this functionality:

// sendEmail($participant->name, $participant->email, $participant->passcode, array('access_number' => $access_number, 'access_code' => $access_code ));

Manager Inteface Setup

Upload Manager folder on your web server (with PHP support) and change window.WEBSERVICE_URL in index.php to real path to your shim.php on a web server.

window.WEBSERVICE_URL = "path/to/shim.php"; 

VoxImplant Setup

After you successfully created and activated your VoxImplant developer account you need to login into VoxImplant admin interface and complete these steps to setup conferencing service:

  • Buy phone number in VoxImplant Control Panel at

  • Create 3 new scenarios using the files from VoxEngine folder of the project (ConferenceGatekeeper.js, StandaloneConference.js, VoxConference.js) at , Warning: don't forget to change WEBSERVICE_URL, BEEP_URL, MUSIC_URL to real URLs

  • Create new VoxImplant application called conference at, its full name will look like

  • Specify rules for the application, they will be used to launch the scenarios using HTTP API or after the incoming call reaches the platform. Overall 3 rules are required:

    1. Name: IncomingCall, Pattern: VoxImplant phone number bought in VoxImplant Control Panel (i.e. 18001231213), Assigned scenario: ConferenceGatekeeper. It will handle incoming calls to phone number connected to the application and first part of the authorization process (access code check).
    2. Name: FwdToConf, Pattern: conf, Assigned scenarios: VoxConference, StandaloneConference (in this order)
    3. Name: StartConfHTTP, Pattern: .*, Assigned scenarious: VoxConference, StandaloneConference (in this order)
  • Connect phone number(s) your've bought before to the application at

Creating conference

Open Manager interface in your browser and log in using admin/admin login/passowrd pair. If everything was done correctly you should see the conference settings including the dropdown list with the phone number(s) you've bought and connected to your VoxImplant conference application: Conference access settings