babblevoice API The API is intended for developers who wish to develop client applications to extend the core functionality of babblevoice. This is the same API we develop our own Netvibes Gadgets (amongst other things). The API feed is all delivered through a REST methodology found at https://www.babblevoice.com/api. Authentication is all done through OAuth and results are returned as JSON. Oauth 1a This standard has been historically our main method.
Intro babblevoice Auto Attendant XML is a language designed to allow developers of web applications to integrate their systems, such as CRM with live auto attendants, allowing them to pass real information in and out of phone calls. This is where an Auto Attendant becomes Interactive Voice Response (IVR). The process is, babblevoice downloads a small, simple, chunk of XML for every step of the auto attendant. This small chunk of XML will contain simple instructions which when combined create powerful Auto Attendant applications (well technically IVR).
babblevoice Desktop provides a very useful interface to enable users to manage telephone calls, see who is on the phone, transfer calls and so on. Please note, this interface is provided as is and without warranty. It is an interface we will continue to develop, but this is in beta, and you are responsible for any code you write against this interface. Beneath the hood, we have provided a scripting interface to allow users to script automation tasks.
Note the q parameter is new and we are planning on releasing it soon. For now it is for reference and maybe subject to change - please check back for more information https://www.babblevoice.com/api/cdr This URL on its own will return a table of CDR data. It has some search parameters. ‘p’ page the page index, default 0 ‘ps’ page size (the number of records to be returned), default 10, maximum 200 ’d’ domain, required ‘f’ date format, ‘dateasepoch’ or nothing.
The device API gives access to devices. A device is typically a phone on the network, but also can represent a SIP server. https://www.babblevoice.com/api/device Returns a table of devices (phones or servers) the authenticated user has access to. https://www.babblevoice.com/api/device/simplecall ‘f’ device full address, for example firstname.lastname@example.org ’d’ destination, the number you wish the phone to call Example https://email@example.com&d=somephonenumber https://www.babblevoice.com/api/device/stats Returns statistics for the specified device. ‘f’ device full address, for example 1000@omniis.
The domain API carries access to parameters around the domain. https://www.babblevoice.com/api/domain The base URL will return a table of domains the user who is authenticated has access to. This includes the unique id, name and bank value. https://www.babblevoice.com/api/domain/getstatus https://www.babblevoice.com/api/domain/setstatus A get/set pair. The status string is a string stored against a domain. It can be used in call rules to send to a phone as a message or even decide on how a call is answered.
The money API gives access to the financial part of babblevoice. https://www.babblevoice.com/api/money/invoices Returns a table of invoice items. Parameters: ‘p’ page, default 0 ‘ps’ page size, default 10 ‘u’ only after unique id (returns a table of entries after the id provided) ’d’ domain, required ‘f’ date format, ‘dateasepoch’ or nothing. Example: https://www.babblevoice.com/api/money/invoices?p=0&ps=10&d=omniis.babblevoice.com&f=dateasepoch https://www.babblevoice.com/api/money/xfer Transfer money from one domain to another. Parameters: * ’s’ source domain name * ’d’ destination domain name * ‘de’ description, optional but recommended * ‘a’ amount to transfer, required
The prefs (preferences) API allows an authenticated user to store preference information against a OAuth session (token). This is useful for storing user preferences so that the only thing the client is required to store locally is OAuth information. https://www.babblevoice.com/api/prefs/set https://www.babblevoice.com/api/prefs/get Get/Set pair. The get returns the document as json encoded. Parameters: ’d’ data, required for get
Access to voicemail stored in voicemail boxes (devices). https://www.babblevoice.com/api/voicemail The root URL will return a table of voicemails available in a voicemail box. Parameters: ‘p’ page, default 0 ‘ps’ page size, default 10 ’d’ device (which includes the username and domain), required ‘f’ format, nothing or ‘dateasepoch’ Example: https://firstname.lastname@example.org&f=dateasepoch https://www.babblevoice.com/api/voicemail/getauthenticatedurl Returns a URL which is authenticated and available for 4 hours. Parameters: ‘u’ unique id, required https://www.
Intro This is currently work in progress. Please contact us if you are interested in using this API. The desktop API uses the presence API to receive events.