We believe setting up business communications should be a straightforward, painless process. That’s why we build our SIP services to play well with whichever communications platform you might use – whether it’s hardware based or hosted in the cloud, built internally or bought from a third-party vendor. In effect, this enables you to Bring Your Own Carrier (us!) to your communications provider. Why is this better than paying for a bundled service from one provider? Because it allows you to benefit from Voxbone’s fully compliant, reliable voice infrastructure and the improved connectivity and scalability of our network while continuing to use your existing apps. It’s a win-win for you!

The following guide will show you how to bring your Voxbone numbers to Voximplant. It’s easy to connect numbers from your Voxbone account to Voximplant’s platform.

What you’ll need to get started:

  1. A registered Voxbone account with assigned numbers. (Create your account here)
  2. A registered account with Voximplant (Create it here)

Note: On both platforms, a free-trial account is also enough to get started!

How it works

Setting up Voxbone numbers for use with Voximplant's platform

When a call is received on our platform, we deliver this call to your designated SIP interface through voice URIs. Behind the scenes, we take care of complex things like least-cost routing, finding the best provider and optimizing for maximum call quality. To connect your Voxbone numbers to Voximplant, we need to establish a SIP interface between our platform and theirs. This can be done in four steps:

 

  1. Allow signalling between Voxbone and Voximplant using SIP Whitelists
  2. Create a SIP interface between Voximplant and Voxbone
  3. Create a voice URI to test the interface
  4. Assign a voice URI to a DID and place a call

Allow signalling between Voxbone and Voximplant platforms

First, we need to whitelist Voxbone’s signalling IPs from the Voximplant side for your apps. You can find a list of our signalling IPs for all our points of presence (PoPs) here.

  1. Log in to your Voximplant account
  2. In the dashboard, go to Programmable Settings >Security > SIP White List or,  if you’re already logged in, click here to go there directly
  3. Add Voxbone PoP IP addresses to be whitelisted, i.e. allowed to send calls to Voximplant platform. Note that we’re not actually using ranges but single IPs with “32” as subset. As the input field only allows you to enter one IP, you can start by using your favourite Voxbone PoP. For example, Belgium Voximplant New User
  4. Keep on adding Voxbone PoP to your whitelist until they’re all there, or the ones you’re actively using are.
  5. All done! Now we can create an SIP interface and link this ACL to it!

Creating a SIP interface between Voximplant and Voxbone

Creating a SIP interface on Voximplant is achieved through the “Users” assigned to an application “Scenario”. Upon creation of a user under a scenario, a SIP URI to access your application directly is automatically created. This would allow us to have a specific voice URI that would point a Voxbone number to a Voximplant application.

Note that this change would not have any impact on your active apps, but just creating a new source of entry to trigger a Voximplant scenario.

  1. In the Voximplant dashboard, go to Menu > Applications, or click here and then find your app to be triggered via incoming calls to a Voxbone DID, or create a new application. The application name will be the domain of the SIP URI with Voxbone. Voximplant New Application
  2. Now, go to your application, then click “Users” to add a new user. Note what you created, as this will be needed in the next step. Make sure the user you created has “Active” state. Voximplant New UserThis is the user name of your SIP URI. When a user is created on an application, a SIP URI to connect to it is automatically generated in the format {username}@{application}. That makes our Voice URI for Voxbone: voxbone-sip@integration.voxbone.voximplant.com
  3. All done! Now that we have a SIP URI, all we need is to configure a Voxbone DID to point to it!

Creating a Voice URI between Voxbone and Voximplant

This is where we set up the SIP interface from Voxbone to Voximplant. On our platform, this is done via Voice URIs. As noted from the previous step, our SIP domain is the application name from Voximplant; “integration.voxbone.voximplant.com” and a standard SIP URI is in the format of user@sip-domain. For example: me@integration.voxbone.voximplant.com..

This is can be done quite easily on our portal or via our configuration API.

  1. Log in to your Voxbone account.
  2. Go to Configure > Configure Voice URIs or, if you’re logged in, click here. Then click “New” to create a Voximplant Voice URI.
  3. Specify the Voice URI as (username)@(your Voximplant application name). For example: voxbone-sip@integration.voxbone.voximplant.com. When you’re done, your Voice URI should look something like this: Voxbone Create Voice URI

Assign your Voximplant Voice URI to a Voxbone DID

Now, we need to link one of our numbers to the Voximplant URI we just created.

  1. Go to Configure > Configure DIDs or, if you’re logged in, click here.
  2. Use filters to pick a number of your choice to assign for testing and hit “Search”.
  3. Once you’ve picked your number, under the Configuration menu, go to the “Voice” tab and click “Voice URI”. Also, make sure to pick at least g.729 and g.711 codecs to prevent any SDP or media-related errors under the “Codecs” menu. Voxbone configure DID
  4. Select the Voice URI you just created from the previous step from the modal window.
  5. Hit “Apply” and “Continue”, then finally, “Confirm”.
  6. All set! Now place a call to the number you are using for testing! It should reach your designated Voximplant Application/Scenario. Voxbone Select Voice URI

Testing calls

Any calls placed to the numbers associated with your Voximplant URI are now delivered by Voxbone to Voximplant. Now, based on the SIP headers, you can keep using your existing app/business logic without changing anything, but use Voxbone as the delivery platform.

For any questions, please contact us