Skip to end of metadata
Go to start of metadata

General principles

There are two main voice routing modes in SAARA: Fixed Rriority Routing and Least Cost Routing. Fixed Priority routing lets system administrator assign fixed priority and weight based routes and Least Cost Routing (LCR) lets administrator to choose routes based on their purchase price. All routes selection are made based on the longest matching prefix, i.e. to select the proper routing group the system will try to find a most matching route based on the first digits of the destination number.

Simplest case: one carrier

The simplest case is where all calls are sent to one carrier. This case does not need any further setup beyond what was explained in Voice Service Quick Start Guide.  If you only use one carrier, please follow the mentioned guide. The rest of this document is intended only for those who are setting up more than one voice carrier.

Master List

The routing is based on the master list - single centralized list of destinations and codes across the system. Only the codes in the master list are considered when making routing decisions. Therefore, for a destination to have separate routing, its codes should be present in the Master List. There are several ways to set up Master list:

Manual Master Code List Entry

Navigate to Routing > Voice > Master List tab. This is a list of Master Code lists in the system. Note, that they are ordered by time, i.e. it is possible to create a new Master Code list for future use with Activation Time in the future without disrupting current operations. To add a new master List for use in future, click "Add Master Code List" button.  A dialog will prompt for Activation Date and option to copy Master List from any of existing versions. It is useful if you want to make some small manual changes in the list and become effective on the future date:

Save the list and click on "View Codes" button of the newly created empty master code list. To start adding destinations manually, click "Add destination" button. Enter destination name and click "Save":  When saved, "Add Codes" button will appear. Add code or more codes one by one:

Add all destinations and codes for which you will need separate routing breakouts, including fixed/mobile, area codes and different mobile operators.

Master Code Upload from file

It is also possible to import master code list from .csv file.  Prepare a file with destination codes and names following this simple example:

33764France - Mobile Bouygues
336059France - Mobile Bouygues
337525France - Mobile Bouygues
337524France - Mobile Bouygues
337523France - Mobile Bouygues
337522France - Mobile Bouygues
337521France - Mobile Bouygues
337515France - Mobile Bouygues
337514France - Mobile Bouygues
337513France - Mobile Bouygues
337512France - Mobile Bouygues
335091France - Mobile Bouygues
336003France - Mobile Bouygues
337511France - Mobile Bouygues

Select the template "Simple 3col" and click "Upload" to start upload. Once finished, click "View Codes" to verify if codes and destinations are uploaded as expected.

You can use Master Code List (CSV) to try the upload. NOTE: the code list is provided as a sample only! The codes change very frequantly and we cannot gauarantee the accuracy of the provided file. Use with caution!

Setting up routing

Once master code list is created, we can now crate actual routes. Go to Routing > Voice > Routing Groups and select a routing group which you want to use. (How to assign routing group to client via Product, see Voice Service Quick Start Guide).

Click "Add Routing Destination" button.  A dropdown list with destinations will appear with the "AZ Destinations (ALL)" on the top. It is important to add AZ destinations to the routing since it will provide a "catch all" route for those routes which are not configured explicitly.

Select the destination you would like to route, and choose from the routing type dropdown:

After destination is added, add all possible carriers where you would like this destination to be routed:

You can add more than one carrier for each destiantion row.

Here are the settings available for each routing type:

Priority routing:

  • Priority: smaller number means higher priority. Routes will be tried starting from smaller number to the biggest, until the call is accepted.
  • Huntstop: if checked, prevents from trying route will less specific breakout. Example, if you check "huntstop" on a  "France - Mobile Bouygues" route and call comes in with prefix 337514, but does not connect, therouting engine will not try to find a less specific route, for example "France" with code 33.
  • Enabled - should this rouet be enabled or not
  • Profit Protection - not used
  • Margin - not used.

Least Cost Routing (LCR):

  • Enabled - should this rouet be enabled or not
  • Profit Protection - if checked, ensures that only those carrier account routes with buy price lower than the sell price, are selected. Currency conversion is respected.
  • Margin - for above Profit protection, but sets minimum profit margin. Example, if selected 10%, and the sell price is $0.10, only routes with buy price below $0.0909 will be included in search. ( $0.909 + 10% = $0.10)


Set as much as separate routes are necessary. Note, that route search is always starting from longest prefix match down to AZ destinations if there are no "Huntstop" checked on the routes in the match list.

Test the route, and observe the call records. Make the corrections if necessary.

  • No labels