Using Voxbone With Pexip

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.  

What you’ll need to get started:

  1. A registered Voxbone account with assigned numbers. (Create your account here)
  2. For Pexip, please contact your Pexip Partner to configure the BYOC interface.

Note: For Voxbone, a free test account is enough for you to follow the steps in this guide and complete a technical validation of the integration of our voice services and Pexip. 

Pexip’s platform’s support for BYOC focuses on the Outbound setup only.

How it works

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 your Pexip, we need to establish a SIP interface between the platforms.

1. Setting Up Outbound Call Routing

For security reasons, it’s important to look at number permissions and SIP digest headers when setting up outbound calling. These will allow you to use a number for multiple applications.

But there are a few steps to take before we get there.

Enabling Outbound

Then check the following:

  • That your Account Manager or Customer Success Manager has activated Voxbone’s outbound service for your account, and for your country of choice
  • That you’ve got 2 test numbers for outbound calling
    These are test numbers in countries that have our outbound service available. Our team will confirm that access has been granted for these numbers.
  • If the country you are using requires Emergency Services to be enabled, please ensure you speak to our team about getting this set up at the same time, as otherwise, it might delay this process.

Go to ‘Configure DIDs’ in the Voxbone platform, and select the numbers you wish to set up for outbound service. Find ‘VoxOut National’ and click it to enable outbound calls. Be sure to hit ‘Apply’ to update the configuration.

This allows you to use this number as an outbound presentation number across any number of integrations.

Enabling SIP Digest Security

The next thing that needs to be set up is the security configuration that Voxbone requires for outbound calling. Voxbone uses SIP Digest headers. To set up the credentials, please go to ‘Configure Outbound Voice’.

Here you can add the username and password used on the system.

Note: We strongly recommend you use the generator tool to create a large, complex key for use within the system. This is a central configuration and only needs setting up once.

Setting Up Call Diversion

Note: Diversion headers aren’t supported on this platform.   It needs to be configured using the Voxbone DID you have purchased and setup.

2. Logging into Pexip Portal

Note: the Pexip Portal is only available to certified Pexip Partners

When you have logged into the Pexip Portal. You need to click on the InterOp pane.

Here at the bottom of the page, you can see the Bring your own carrier setup.

We want to go in and configure the Add Proxy configuration.

Here we want to add the details we generated earlier in the process.  Name the Proxy Tag Voxbone, add in outbound.voxbone.com / 81.201.89.110 for the Proxy and backup Proxy addresses.

In the SIP Username and password pass in the Configuration you setup “enabling SIP Digest Security”

Once done, then go back to the Add BYOC Rule.

Here we can add the DID we’ve set up in step 1, add the DID with the full E164 number including the country code. Make sure the prefix contains + so it’s a full E164 dialing sequence.   Then select the Proxy Set we’ve just setup by clicking on Voxbone from the proxy Set drop done.

3. Setting Up Inbound Call Routing

Note: This guide was initially only set out to help configuration of outbound services, but due to strong interest in using our inbound services with Pexip, we have added the additional steps for configuring inbound capabilities below (18/12/2020).

This is where we set up the SIP interface from Voxbone to VC endpoint. On our platform, this is done via Voice URIs. As noted from the previous step, our SIP domain is “yourVCEndpoint.com” and a standard SIP URI is in the format of [email protected] For example: [email protected]

  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 Voice URI.
  3. Specify the Voice URI as {E164}@yourVCendpoint.
  4. Please note if you are using TLS, the voice URI has to have the following added to the end e.g ;trasnport=TLS

Adding the URI to the number:

  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 Platform - Select Voice URI
  4. Select the voice URI you created from the previous step, from the popup window. voxbone uri
  5. Hit “Apply” and “Continue”, then finally, “Confirm.”

Pexip Users

Our thanks to our friends at Pexip for access to their system and lab environment and for the help in getting this research lab setup and working.

For Pexip users looking to configure the BYOC interface please contact your Pexip Partner or contact Pexip directly here.

For any questions, please contact us.