Getting Started

If you want to build your own app from scratch in another language you can. You can decide whether to authenticate via basic auth or use token generators.

Authentication via basic auth

Basic authentication permits anyone with the code to call your DID within the security parameters defined by voxbone – this is the fastest way to get started and how most Voxbone SDK customers start.

Provide your username and webrtc key in the basicAuthInit() function.

voxbone.WebRTC.basicAuthInit(username, secret_key)

Authentication with token generator

In the advanced authentication mode, you run your own authentication server with our samples and can control who can and cannot make a call against your DID.

An authentication token needs to be provided for initializing the voxbone.WebRTC object.

var voxrtc_config{
   “key”:”ABwxcFX6ayVxu/uNuZu3eBsjrFeg=”,
   “expires”:1426067127,
   “username”:”a_username”
}

Then use it with the voxbone.WebRTC object.

voxbone.WebRTC.init(voxrtc_config)

  • username: This is your credentials username
  • expires: expiration date of the generated key (in seconds, epoch time)
  • key: this is a base64 representation of an HMAC SHA1 of expires:username, salted with your password.

 

Advanced Auth Token Generator Examples

Various example on how to generate the authentication token can be found on Github such like

 

Make a call

Making a call to any Voxbone DID or SIP endpoint.

var dest = “+32000000000”;
voxbone.WebRTC.call(dest);

Send DTMF

The code below shows you how to send a DTMF tone when in a phone call.

var digit = “1”;
voxbone.WebRTC.sendDTMF(digit);