Professional Documents
Culture Documents
Configuring
Voxbone services
Table of Contents
Configuration basics
{E164}
DNS lookup 16
Caller ID (CLI) 17
Configuring SMS
Configuring fax
Configuring faxing 35
Configuration defaults 38
Confidentiality
Configuration basics
The most important thing is making sure your network can accept Voxbone traffic. At
a minimum it should be configured for traffic from the nearest Voxbone ‘SuperPoP’.
Tip: Voxbone’s network is fully geo-redundant. This means that if anything goes
wrong at one of our data centers, all the traffic flowing there will immediately
be diverted. On your end, that means business as usual. To take advantage
of this free failsafe system, make sure your network accepts traffic from all
Voxbone SuperPoPs.
If you need help configuring your equipment, take a look at our guide for the most
common types of software here.
2 Click 'New'.
3 Enter a valid URI, and a description that will help you recognise it.
4 Click 'Save'.
If you want to setting up call forwarding, these steps are slightly different. See Page 9
for more.
Tip: don’t just create one Voice URI. Make sure you create two or more and
designate one as your back-up URI, in case your primary URI is unavailable.
If that happens, we’ll automatically direct all traffic to the back-up instead.
Voxbone lets you use two variables in your URI: E164 and CPC/ANI. CPC and ANI
variables are for toll-free numbers only.
{E164}
This variable adds the E164 value of each phone number to your URI, which in turn lets
you map a unique URI to your phone numbers.
The E164 variable can be used alone, or combined with extra characters. Here are
some examples.
These variables are only used for toll-free numbers. They let you add information about
the calling party category (CPC) into the URI.
The Calling Party Category, or CPC, tells us what kind of caller is getting
in touch – specifically, whether they’re from a mobile network, a landline/
Definition fixed-dial network, a payphone, or something else.
The CPC might influence how much the call to your toll-free number costs.
If the calling party is using a landline, for instance, that will usually cost a
bit less than if they were on a mobile phone.
Cellular cellular 02
Payphone payphone 03
Unknown unknown 00
Here’s an example: Someone using a mobile phone calls your toll-free number, which is
+1800 555 1234 The provisioned SIP URIs for that number could be expanded like this:
Number Number
CPC Format Result
dialed type
{E164}{ANI}@customer. 1800555123402@
+1800 555 1234 Toll-free Mobile
com customer.com
{E164}@customer. 18005551234@customer.
+1800 555 1234 Toll-free Mobile
com;cpc={CPC} com;cpc=cellular
{E164}{ANI}@customer. 17145551234@customer.
+1714 555 1234 Regular Mobile
com com
{E164}@customer. 17145551234@customer.
+1714 555 1234 Regular Mobile
com;cpc={CPC} com;cpc=unsupported
Because the second two examples are calls placed to regular (not toll-free) numbers,
the ANI and CPC variables in the resulting number are blank and “unsupported”
respectively.
Tip: URI parameters are easy to change or remove. Just navigate to the
‘Operations’ option on the right-hand side, and select the right button.
This protocol's name hints at what it is: the use of a telephone number as a URI. The
phone number you use as the URI here is the one to which you'd like your calls forwarded.
Tip: To forward calls from a Voxbone number, make sure that number is fully
enabled for outbound calling (Page 22). Ask your Account Manager to enable
TelURI specifically.
3 Enter a valid phone number, and a description that will help you recognise it.
4 Click 'Save'.
1 Go to the 'Configure' menu at the top of the screen and select 'Configure
DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
6 Search for the Voice URI you'd like to configure, and tap 'Select'.
The pop-up window will close. Select the phone number you'd like to configure
7 by ticking the box on the left (or tick the box next to 'Number', in the column
header, to select all).
8 Click 'Apply'.
9 You’re done! Your phone numbers are now configured to a SIP URI.
To receive calls, you'll need to map your phone numbers to channels (sometimes called
'trunks') within the Zones you want.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
If you want to configure numbers in bulk, select the box next to 'Number' on
4 the leftmost column.
Tip: you can choose to limit the number of simultaneous calls received and
dialed by a single number by selecting ‘Limit channels’ below the ‘Service’ tab.
If you don’t specify a limit, the number will share capacity with all your other
numbers in the same Zone. To remove limits, select the ‘Maximum’ box and
then click ‘Apply’.
Capacity groups let you set up groups of phone numbers, within which you can limit the
number of simultaneous calls they can make/receive.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 capacity groups'.
2 Click ‘New’.
Give your new group a name and set its capacity (i.e. the number of calls that
3 phone numbers in the group can simultaneously make/receive).
Tip: Your alert threshold is the percentage of capacity used before you’re
notified. So if you have a capacity group whose capacity is 20, and your alert
threshold is 50%, you’ll be notified when a member of your capacity group is
making/receiving 10 simultaneous calls.
When you’re ready to add specific phone numbers to your capacity group, follow
these steps.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the phone numbers you’d like to edit, or select all by ticking the
5 box next to ‘Number’ on the leftmost column.
Navigate back to the ‘Configure’ menu and select ‘Configure capacity groups’.
1
2 Search for the capacity group you’d like to edit (or click ‘Search’ to display all).
3 Click the three purple dots next to the name of your chosen capacity group.
Voxbone has five major Points of Presence (PoPs). You can configure your numbers
individually to your preferred PoP like this:
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
5 to ‘Number’ on the leftmost column.
Tip: make sure your firewalls are configured to accept traffic from all Voxbone
PoPs. Their IP addresses are listed here.
Voxbone offers all the main codecs on the market, including newer ones like HD Voice
or Video. You can also choose your codecs on a number-by-number basis.
G711a Opus
G711μ VP8
G729 (A) H264
Speex (8, 16, and 32 kHz) H263+
G722
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
6 to ‘Number’ on the leftmost column.
DNS lookup
If you’ve used a domain name as the host in your URIs, you can specify which record
Voxbone looks up in the DNS to determine the location of your platform.
Caller ID (CLI)
Voxbone can deliver caller ID (also called CLI, or Call Line Identification) in three formats,
as shown below. You can also choose your CLI format on a number-by-number basis.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
6 to ‘Number’ on the leftmost column.
Voxbone can deliver DTMF in the following formats. You can also choose your DTMF
format on a number-by-number basis.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
6 to ‘Number’ on the leftmost column.
The DNIS allows you to receive the number dialed by a caller inside the SIP header. Like
the services above, this can be activated on a number-by-number basis. Here’s how to
do just that.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
5 Tick ‘Enabled’.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
6 to ‘Number’ on the leftmost column.
The calling party category (CPC) records the kind of network an incoming call is from
(e.g. mobile, landline, payphone).
With Voxbone, you can block certain kinds of CPC on toll-free numbers, which helps
you control your per-minute fees. We’re rolling this feature out to a growing number of
countries.
You can block or enable calls from fixed-line, mobile (cellular), or payphone sources.
Here’s how.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
5 Tick ‘Enabled’.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
6 to ‘Number’ on the leftmost column.
Configuring
Outbound Calls
Tip: If you want to make outbound calls, make sure that you buy numbers
that offer outbound dialing (“VoxOUT international”). You’ll find this listed in
the ‘Features’ column when you go to buy a number. You can also filter your
search to include only outbound-enabled numbers.
Voxbone offers two kinds of outbound services: national and international. They differ
in the kinds of numbers they can reach.
International National
Benefit outbound outbound
Now it’s time to get started. Before anything else, you’ll need to activate the outbound
service from your Account Manager. This is easily done by messaging them directly.
Like with some other Voxbone services, you’ll need credit in your usage account to start
making outbound calls. Once you’re activated and topped up, you’re ready to configure
Voxbone for outbound. Here's how.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1
outbound voice'.
Tip: Click 'Generate' and we'll create a secure password for you. Keep your
password safe: if you end up changing it, all the services you've set up with that
password will stop working until you enter the new one on your equipment.
3 We recommend that you add a maximum call duration (in minutes) for
outbound services. This helps prevent misuse or accidental wastage of the
service.
Click 'Save'.
5
Now you're ready to configure your Voxbone phone numbers to make outbound calls.
Follow the instructions below and you'll be ready to go.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
4 Tick ‘Enabled’.
Tick the phone numbers you’d like to edit, or select all by ticking the box next
5 to ‘Number’ on the leftmost column.
Tip: This can also be done using our Provisioning API. Find more
information here.
If for any reason your call isn’t connected, the call detail record (CDR) created will have
a ‘blocked’ status listing the cause of failure.
Diversion headers
As well as using your Voxbone phone numbers to make calls, you can send non-
emergency calls over the Voxbone network using another phone number that you own.
To do this, just make sure you include a Voxbone phone number in the diversion header
of the SIP invite.
A diversion header is a field of a SIP call that's added when the call is
diverted, such as when it's forwarded. Calls can be diverted multiple
Definition times, and be initiated by a user or by the network itself.
Configuring SMS
We’re constantly expanding the list of countries in which we offer texting services.
All Voxbone mobile numbers support SMS, and some national and local (geographic)
numbers do too.
Tip: Using texting services on a given Voxbone phone number doesn’t affect
your ability to receive calls on it.
The prices for sending texts to the same country are here.
The prices for sending texts internationally are here.
The prices for receiving texts are here.
Before you get started receiving texts, you’ll need to create an SMS link group. This lets
you add several methods or routes with different weight, which can be used for load
balancing or backups (redundancy). Here’s how.
Tip: You can also carry out this process using our Provisioning API. Visit our
developers’ portal here and search for ‘SMS’.
Now you’ve created a link group, all you need to do is create an SMS link itself:
Select your preferred protocol. This will determine the rest of the fields you
4 need to complete.
Adjust load balancing, monitoring, system type, and other values depending
5 on the protocol you’ve selected.
A note on protocols:
For outbound/bi-directional links, the only supported protocols are SMPP and REST JSON
For SMPP you can choose to set up your connection as SMPP (ESME) or SMPP (SMSC)
If you’d like Voxbone to connect to your equipment, then select SMPP (ESME)
If you’re using your own SMPP server, then select SMPP (SMSC)
For inbound links, you need to choose the protocol (SMPP, SIP and SMTP) and the traffic direction
(i.e. from Voxbone)
Field Value
Direction Bi-directional
Protocol REST_JSON
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
3 Select ‘SMS link group’ from the buttons below ‘Available configuration options’.
4 Click the empty box under ‘SMS link group‘, and select the link group you’ve made.
Tick the mobile-enabled phone numbers you’d like to add, or select all by ticking
5 the box next to ‘Number’ on the leftmost column.
6 Click ‘Apply’.
Tip: To make sure you pick up texts, check that you’ve got credit in
your prepaid Voxbone account.
The way you configure your network depends on your protocol of choice. Voxbone is
running version 3.4 of SMPP.
Note: We strongly recommend using TLS for the sake of your communications security.
Alternative IP
Protocol IP address address
Configuring outbound texting requires a few more steps. To get started, request
activation of the service from your Account Manager. This is easily done by messaging
them directly.
Once you’re activated, here’s how to enable outbound texting on specific phone
numbers. Not all Voxbone numbers support outbound SMS, so make sure to select only
those that have a tick in the ‘Outbound SMS’ column.
Go to the 'Configure' menu at the top of the screen and select 'Configure
1 DIDs'.
Enter your search parameters, or click ‘Search’ to display all your phone
2 numbers.
4 Select ‘Outbound SMS’ from the buttons below ‘Available configuration options’.
Tick the SMS-enabled phone numbers you’d like to add, or select all by ticking
5 the box next to ‘Number’ on the leftmost column.
6 Click ‘Apply’.
Once you’ve followed the steps above, here’s a quick checklist to make sure
everything is set up properly.
If any of the conditions above aren’t met, the text will be blocked, and the CDR
will have a ‘blocked’ status.
Tip: If your SMS can’t be sent, the system will try again every 6 minutes for
48 hours. After this, the SMS will be deleted, and a CDR with the status ‘time
out’ will be created. Tip: For more information on service restrictions, check
this link.
Once you send a text, a call detail record (or CDR) will be created, and a delivery report sent.
You can find all your CDRs by going to the ‘Account’ menu within the portal, and
selecting ‘Call history.’
Choose between the ‘Inbound’ and ‘Outbound’ tabs, and select ‘SMS’ under ‘CDR type’
to see records of texts you’ve sent and received.
Configuring fax
(formerly VoxFax)
Tip: If you want to use faxing and T.38, make sure that you buy numbers that
offer these features. (“VoxFax” and "T.38"). You’ll find these listed in the
‘Features’ column when you go to buy a number. You can also filter your search
to include only fax or T.38-enabled numbers.
Configuring faxing
Voxbone lets you receive faxes over your Voxbone numbers in either .tiff or .pdf format.
These messages can be delivered through one of two protocols: SMPT or HTTP POST.
Just like with voice, to receive faxes, you'll need to configure your fax URI. Here's how.
2 Click 'New'.
Choose whether you want to use HTTP or SMTP by using the tabs in the pop-
3 up box that appears. Then you’ll be able to select your preferred file format
and fill in the URI, as well as the CSID.
Now you’re ready to set up your phone number to receive faxes. It’s important to note
that for each number, you have to choose between receiving inbound voice calls and
receiving faxes: you can’t receive both on the same number.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
4 Enter the fax URI you've configured or use the drop-down menu.
Tick the phone numbers you'd like to configure, or select all by ticking the box
5
next to 'Number' on the leftmost column.
Tip: The SMTP address from which your faxes will originate is, by default, a
Voxbone address. To whitelabel the service, we’d recommend installing an
SMTP proxy server between Voxbone and your end-users.
T.38 is a kind of protocol for sending faxes over a data network. It involves
converting the fax signal to an image before sending it to another fax
machine.
Definition If that fax machine is also T.38 capable, it will convert the image back
into a fax signal. This isn't necessary for the fax to work, but it's ideal.
We're constantly expanding our support for T.38 fax, and you can check our current
coverage here.
2 Search for the DIDs you want to configure, or click 'Search' to display all.
Tick the T.38-enabled phone numbers you'd like to add, or select all by ticking
5 the box next to 'Number' on the leftmost column.
Configuration
defaults
These will determine the configurations for all new Voxbone numbers that you buy.
Setting them up is completely optional, but lets you skip lots of hassle if you’re using
lots of numbers for the same thing (but buying them at different times).
Choose between defaults for routing, capacity, caller ID (CLI), codecs, call
2 blocking on toll-free numbers, media, and more.
You can see all your configuration defaults in one place, and adjust them at any time.