Skip to content
VoiceChat is a set of APIs to create conference rooms on the fly to be used in the browser. Its built using the Plivo WebSDK and APIs.
JavaScript HTML Python
Latest commit dba07c3 May 9, 2016 @cachrisman cachrisman updated readme

README.md

VoiceChat

VoiceChat is a set of APIs to create ad-hoc conferences to be used in the browser. Its built using the Plivo WebSDK and APIs.

Looking to self-host?

Automatically Deploy to Heroku

  • Create a Plivo account
  • Create and verify a Heroku account if you don't have one then click the button below.

Deploy

Manual Installation

Clone this repo

$ git clone https://github.com/plivo/voicechat.git

Configure

Create a Plivo account if you haven't already

Deploying to Heroku

Create and verify a Heroku account if you haven't.

$ cd voicechat
$ heroku create {app_name} -s cedar
$ git push heroku master
$ heroku addons:create redistogo:nano --app {app_name}
$ heroku ps:scale web=1

Add Plivo Auth ID and Auth Token to env from the dashboard.

$ heroku config:set PLIVO_AUTH_ID={PLIVO_AUTH_ID}
$ heroku config:set PLIVO_AUTH_TOKEN={PLIVO_AUTH_TOKEN}

Test your application

Go to {app_name}.herokuapp.com

API Docs

Create a conference name

POST /api/v1/conference/

Example

$ curl -XPOST http://voicechatapi.com/api/v1/conference/
{
    "conference_name": "p12ygdwt1",
    "conference_url": "http://voicechatapi.com/p12ygdwt1/"
}

Call a mobile & landline phone number (PSTN) into the bridge

POST /api/v1/conference/<conference_name>/

Parameters

to - The phone number to be called.
clid - The caller id which will be used. (The phone number to be shown in the recipient's phone.)

Example

$ curl -XPOST -d "to={1415123####}&clid={1415123####}" http://voicechatapi.com/api/v1/conference/<conference_name>/
{
    "success": True,
    "message": "Call has been queued"
}
Something went wrong with that request. Please try again.