Configure the routing rules

The routing rules are used to tell the PBX how to handle calls (inbound and outbound) based on various selection criteria. Routing takes care of selecting the gateway on which to forward outgoing calls, sorting incoming calls to the different entities of the switchboard. A routing rule is essentially composed of a criterion that allows you to associate numbers to one and only one entity and then decide the route for the destination of a call.
NOTE: This section of the PBX should normally only be used for special advanced settings (see below), as the main routes for outgoing and incoming calls are made through the LCR module and the Company Number Wizard.

From the Toolbox -> Routing menu you can access the list of existing routing rules. The buttons , , are used respectively to delete, consult and modify the configurations.

To create a new routing rule, click on the icon . The available parameters are the following:

Parameter	Description
Company	Company for which the rule is applied
Description	Convenient description for the rule
Enable	Enable / disable the rule
Caller Type	Type of caller on which the rule is triggered. There are 2 types: External: all calls coming from Gateway Internal: calls from PBX entities (users, IVRs, etc.)
Caller Number	It is the calling number or prefix. For the insertion rules see. REGULAR EXPRESSIONS further down. The wildcard ‘%’ generalizes the rule for any calling number
Table Hourly	Indicates when the rule must be applied, by choosing an hourly table
Number Called	It is the number or area code called. The wildcard ‘%’ generalizes the rule for any number called.
Rule	Allows you to select the type of rule, choosing between “Routing” and “Mapping”
In the street to	If in the previous item “Routing” was chosen, it indicates the entity on which the call managed by the rule (User, Group, Gateway, IVR) will be routed; in particular, by selecting the Gateway item it will be possible to access two other items: Select a gateway: allows you to select a gateway from the list of existing corporate gateways Precedence: valid only for outgoing rules, indicates the sequence of choice in the event that multiple gateways have been chosen in the LCR for the same prefix
Number Mapped	If “Mapping” has been chosen in the previous item, this field allows you to enter the number on which the call is mapped; the rule is useful for creating short numbers (eg Enter a code to call company mobile phones) or to manage direct dialing.
Integration enabled	Activates the SSN integration for the current routing rule: when the call “transits” for this rule, the PBX will execute the script indicated based on the selected event (for more information see the Settings section of the chapter configure the company ).

NOTE: Please note that routing rules can be used to trigger automatic call recordings. The operation is possible ONLY through the GDPR panel located in Configuration–> GDPR (see GDPR Panel – Reporting)

RULES SELECTION CRITERIA

The routing rules for a call for a particular number (N) are chosen by the system based on comparison criteria: each comparison provides a score. The scores obtained from the different comparisons are added together and the results obtained are used as priority values: the rule that obtains the highest score will be chosen. Within a company, the criteria used for choosing a rule are as follows:

1. Called Number: the number N is compared with the number called. The highest score is assigned to the rule that provides the highest number of matches, that is the longest match (eg: a rule for the entire prefix “347” wins over the rule for the prefix “3”, when calling 347 / 1234567);
2. Time slot: if there are two or more matches with the same score in point 1, the time slot is compared: the highest score is assigned to the rule in which the time slot (if set) includes the current time of the call in progress;
3. Caller Number: if there are two or more matches with the same score in point 2 or no time slot is set, the set caller number is compared. Again, like point 1, the higher the match, the higher the priority.

REGULAR EXPRESSIONS (ESPRESSIONI REGOLARI)

In order for the checks to be carried out on entire categories of numbers (eg national, district, international, mobile, etc.) it is possible to define ranges of numbers and strings in a powerful and flexible way thanks to the introduction of regular expressions. A regular expression is a sequence of symbols (hence a string) which in turn identifies a set of strings. Thanks to a particular symbology and a simple syntax it will be possible to build rules to identify sets of numbers.

VOIspeed 6 uses a subset of regular expressions commonly known in the IT field: to be precise, 2 symbols are used to identify the beginning and end of strings and a wildcard symbol to identify any string.

Note: the routing rules compare the criteria entered by the administrator with the numbers always starting from the first character, so you will notice how the system always automatically inserts the beginning of string symbol (^) even if omitted by the administrator. This also implies that when you insert the end-of-string symbol ($), you are in fact defining a complete number (which assumes an exact 1: 1 comparison).

Here are some other examples:

If more than one criterion is successful in the comparison with a number, the criterion that contains the greatest number of digits will be chosen (i.e. the one that offers the longest match). For example, with the numbering 02123456789, between the two criteria ^ 02123 and ^ 02, the first would “win”.

MAPPING

Mapping rules apply a “transformation” from one number to another. The mapping is used for the management of direct dialing and the creation of short numbers to call real numbers (for example the company cell phones of your colleagues).

In this last case, it is very simple to create a short number to call a real number: for example, if you want to use the code 4444, to call 3471234567, the rule will be done like this:

Warning: do not use codes that coincide with the switchboard extensions or with the emergency numbers (112, 113, 118, etc.)