How to block calls from blacklisted contacts
The Article describes how to block calls from blacklisted contacts via Dialpan.
Created: December 2015
Updated: June 2019
Permalink: https://wildix.atlassian.net/wiki/x/qQPOAQ
Block calls via Dialplan
Step 1. Phonebook configuration
You can add blacklisted contacts to your phonebooks in different modes: from Collaboration, from the imported backend (MySQL, сsv, etc). Here it is described how to add a contact in Collaboration.
- Go to Collaboration -> Phonebook
- Select the desired phonebook and press + to add a new contact
- Set blacklist as a Type of contact
Consult Collaboration User Guide for detailed information about how to create phonebooks and contacts.
Step 2. Dialplan configuration
- Create a separate Dialplan procedure for managing calls from blacklisted contacts
- Configure the behavior of managing these calls. For example, add Hangup application
- Go to Dialplan procedure used for managing incoming calls ("main" procedure)
- Add the applications to check if a call is from a blacklisted contact:
- Jump to if call type is -> blacklist -> route calls to the previously created Dialplan procedure for blacklisted calls - if a call is from a blacklisted contact, it is dropped
- Call group -> if it is a normal call, it is routed to a Call group
Alternative Way. Block calls via tagging in Phonebooks and Dialplan
Step 1. Create a dedicated phonebook with blocked users
To define a contact as blacklisted, add [blocked] tag to its name. Detailed information about how to create phonebooks and contacts can be found in Collaboration User Guide.
Note: If a contact is present in other phonebooks, you need to move it to the dedicated phonebook or replace/ rename it in another phonebook. Otherwise, [blocked] tag cannot be applied.
Step 2. Configure Dialplan
Modify Dialplan procedure used for managing incoming calls by adding Dialplan applications:
- Verify caller -> [blocked] -> Blocked procedure - If caller name contains [blocked] tag, a call is routed to Dialplan procedure created for managing calls from blocked users ("Blocked" in the example)
- Dial the phone - if caller name does not contain [blocked] tag, a call is routed to this step