How Can We Help?

How to Create VIP Numbers (Black List)

In some particular situations it may be necessary to route calls from certain numbers in a different way than the standard call flow.

For example, some numbers would be good if they had a preferential path to be routed to a specific response group (VIP numbers), or, vice versa, they would undergo the opposite treatment, directing them to a responder with a dissuasion message (Black list).

It would also be advisable for the configuration of the numbers to be treated in a differentiated manner to be partially or entirely delegated to the end customer, through an easy-to-use interface.

Given the above, it is unthinkable to use the PBX routing rules, because the calling number is only evaluated as a last parameter, making configuration and maintenance of the system very complex.

It was therefore decided to terminate all calls coming from outside on an IVR (or even more than one IVR), evaluating the calling number with an external script.

This script, supplied as standard on all PBXs, will evaluate the calling number thanks to a table filled in by the end user who will have to decide for each calling number where to route the call, choosing between a group, a user or an IVR.

It is therefore necessary to create at least one processing IVR where incoming calls abut. If there are more IVRs in input (N), the configuration will have to be repeated on the N IVRs.

The IVR must have a root node aimed exclusively at evaluating the incoming call through a script and must be created with the following characteristics: • No audio • User input not required • Node Action: Execute External Script • URL Script:

http://host_pbx:3542/PBX/seri_endpoint.php?service=do_integration&integration_name=vipNumberV2&license_id=INSTALL_ID&dummy=

where is it:

  1. host_pbx is of the type “markab.cluana.com”, “gienah.cluana.com”available from Integrazione, coordinates Polyedro
  2. ID_INSTALLATIONZIONE is of the typeMP123456789” … available from Integrazione, Polyedro coordinates

The apparently wrong parameter “dummy =” is used to cancel the “?” that the PBX concatenates at the end of the URL.

In addition to the root node, there must necessarily be a child node with the key “1”. All calls not otherwise intercepted by the script will end in this node (default numbers node or default node).

The default node should be considered as the true root node of the responder, the node from which to restart with the tree structure for all calls that are not intercepted by the script.

As for the configuration of the tables, the URL must be saved as a bookmark on the browser for each power user of the PBX:

https://HOST_PBX/PBX/seri_endpoint.php?service=do_integration&integration_name=vipNumberV2&license_id=INSTALL_ID

  1. HOST_PBX is present in the Configuration–> Company–> Info section and is equivalent to the SIP Host item;
  2. INSTALLATION_ID is the alphanumeric string found in brackets at the top right of the header of the WEB configurator of your switchboard.

From this web page it will be possible to configure the table.