AdminGuide:Service:Blacklist

Return to AdminGuide:Service

Blacklist

• Introduced in version 4.5.17

Description

This service lets you define specific routings for inbound calls based on the calling and called numbers.

For each pair of numbers, you can choose whether or not to play an audio file (even "in progress") and define the failover action to carry out (among the routing actions available on KPBX).

The pairs of numbers to which the same routing policy should apply can be grouped in blacklists to use on different inbound lines.

The blacklists are applied to inbound calls, so in a single-tenant system they can be linked to the gateways and VoIP domains. In multi-tenant systems, the blacklists are managed by the tenant admins and are linked to the assigned lines.

You can also link a list of blacklists to each inbound line. These blacklists will be applied in a cascade after the manipulation rules and before the DID rules associated to the line.

Configuration

To configure the service, you must first define the blacklist and then associate it to an inbound line.

1. The service can be configured in the PBX -> Gateways and VoIP domains -> List of blacklists page.

N.B.: In multi-tenant systems, the service can be configured in the PBX -> Assigned line management - Nel caso di PBX multitenant la configurazione viene effettuata nel pannello PBX -> Gestione delle linee assegnate -> List of blacklists page.

In questo pannello è possibile creare una nuova blacklist attraverso il pulsante “Aggiungi blacklist” oppure editarne una esistente.

I campi del form per la definizione della blacklist sono i seguenti:

• Abilitato: flag di abilitazione della blacklist. Se il flag è disabilitato le regole della blacklist non verranno valutate anche se questa e’ inclusa in una o più linee in ingresso
  
• Nome: il nome mnemonico univoco da assegnare alla blacklist
  
• Riproduci i messaggi “in progress”: flag che, se abilitato, permette di riprodurre l’eventuale file audio selezionato nell’azione di trabocco in una sessione 183 Session Progress
  
• Trabocco: specifica l’azione di failover da compiere quando si verifica il match di una delle regole che compongono la blacklist. Nelle blacklist e’ presente l’azione “Continua ai DID”, con la quale è possibile implementare la funzionalità di “whitelist” e proseguire l’instradamento verso i DID al match di una delle regole
  
• Regole: le regole prevedono la stessa logica delle regole di manipolazione, con la selezione della tipologia di chiamante e chiamato con l’inserimento delle numerazioni per i match. E’ possibile aggiungere una nota per ogni regola a scopo puramente gestionale, le note non hanno nessun ruolo operativo sul matching delle regole. Ogni regola ha un flag di abilitazione, le regole disabilitate non vengono valutate durante l’applicazione della blacklist.
  

Le regole sono ordinabili ma anche l’ordinamento, come le note, ha uno scopo puramente gestionale per raggruppare logicamente delle regole. Avendo tutte la stessa azione di failover, il primo match innesca l’azione.

2. L’associazione della blacklist alla linea di ingresso viene effettuata su gateway e domini VoIP nel pannello PBX -> Gateway e domini VoIP -> Linee in ingresso / uscita

NOTA: Nel caso di PBX multitenant la configurazione viene effettuata nel pannello PBX -> Gestione delle linee assegnate -> Linee assegnate.

Indipendentemente dallo scenario in cui ci troviamo l’assegnazione viene sempre fatta cliccando su “Aggiungi blacklist” ed aggiungendo tutte le blacklist necessarie.

È possibile disabilitare ogni singola associazione delle blacklist con la linea in ingresso in modo che le regole contenute non vengano valutate.

È possibile anche modificare l’ordinamento delle blacklist all’interno delle linee in ingresso, in modo da implementare sia meccanismi di blacklist che di whitelist.