Overview
This article will walk through creating a DNC Lookup Provider with Blacklist Alliance. There are configurations for the Single and Bulk Lookups. Followed by Testing instructions and the process to apply the Blacklist Alliance Lookup in your Campaign.
Contents
- Adding a DNC Lookup Provider
- Editing a DNC Lookup Provider
- Single DNC Lookup for Blacklist Alliance
- Bulk DNC Lookup for Blacklist Alliance
- Test Setup
- Apply DNC Lookup in a Campaign
Adding a DNC Lookup Provider
1.) Click the Apps main menu.
2.) Click the DNC Lookup menu option.
The Show DNC Lookup Providers page will open.
3.) Click the Add DNC Provider button.
The Add DNC Lookup Provider page will open.
4.) Configure the fields as needed.
Editing a DNC Lookup Provider
1.) Click the Apps main menu.
2.) Click the DNC Lookup menu option.
The Show DNC Lookup Providers page will open.
3.) Click the Provider Name or Edit in the Action gearwheel drop-down.
The Edit DNC Lookup Provider page will open.
4.) Reconfigure your Provider settings as needed.
Single DNC Lookup for Blacklist Alliance
The Single Lookup only checks numbers for Manual Calls or Preview Dial Campaigns.
1.) Configure your settings as needed using the following as a guide.
- (A) Name: Blacklist Alliance
- (B) API URL: https://api.blacklistalliance.net/lookup
- (C) Request Method: Get
- (D) Request Type: JSON
- (E) Response Timeout in Seconds: 6
- (F) Response Retry: No retry
Request Header
| Parameter Name | Parameter Value |
| accept | application/json |
Request Parameters
| Parameter Name | Parameter Value |
|
phone |
{phone_number} |
| key | customer provided key |
| ver | v1 |
| resp | json |
- If you are configuring a new DNC Provider, click the blue Add button for additional Request Parameters.
Response Parameters
| Key | Path | Map to Variable |
|
phone |
phone | {phone_number} |
2.) Add a Group.
- (A) Click the blue Add Group button. The New Group table will open.
- (B) Click Add Item.
- (C) Fill in the fields as needed.
3.) Click the Save DNC Provider button to save your settings.
- See the Test Setup section for testing instructions.
Bulk DNC Lookup for Blacklist Alliance
The Bulk Lookup only checks numbers for Predictive or Power Dial Campaigns.
1.) Configure your settings as needed using the following as a guide.
- (A) Name: Blacklist Alliance
- (B) Enable Bulk Requests: Yes
- (C) API URL: https://api.blacklistalliance.net/lookup
- (D) Request Method: Get
- (E) Request Type: JSON
- (F) Response Timeout in Seconds: 60
- (G) Response Retry: No retry
Request Header
| Parameter Name | Parameter Value |
| accept | application/json |
Request Parameters
| Parameter Name | Parameter Value |
|
phones |
{phone_numbers} |
| key | customer provided key |
| ver | v1 |
| resp | phonecode |
- If you are configuring a new DNC Provider, click the blue Add button for additional Request Parameters.
Response Parameters
| Key | Path | Map to Variable |
|
Phone |
/Phone | {phone_number} |
2.) Add a Group.
- (A) Click the blue Add Group button. The New Group table will open.
- (B) Click Add Item.
- (C) Fill in the fields as needed.
3.) Click the Save DNC Provider button to save your settings.
- See the Test Setup section for testing instructions.
Test Setup
The Single and Bulk tabs have a Test button that works the same way. The only difference is you can enter more than one number on the Bulk tab.
1.) Click the Test button.
The Test DNC Lookup Numbers modal will open.
2.) Enter the phone number(s) to be tested in the Test Numbers field.
3.) Click the green Test button.
A Results field will open with the API response for the number(s).
4.)Click the Cancel button or the X in the top right of the modal window to close.
Apply DNC Lookup in a Campaign
1.) Click the Call Center main menu.
2.) Click the Campaigns menu option.
The Show Campaigns page will open.
3.) Open your Campaign's settings by clicking the Name or selecting Settings from the Action gear-wheel drop-down.
The Campaign Settings page will open on the General tab.
4.) Click the Leads tab.
5.) Scroll down to DNC Settings and configure Primary Lookup.
- (A) Select the Blacklist Alliance Provider in the drop-down.
- (B) Click the toggle to Active.
6.) Click the blue Apply Changes button.