Do-not-call and TCPA screening
Keep do-not-call lists working on every campaign, add numbers to them, and screen each number against Blacklist Alliance before it is dialed.
Campaigns & leads · 4 min read

This guide covers the tools that keep you from calling people who should not be called: your do-not-call (DNC) lists, and screening every number against the Blacklist Alliance list of known TCPA litigators before it is dialed. They lower your risk. Following the rules for where you call is still your responsibility.
What you need
- For DNC lists: the account owner, or a team member allowed to make changes on the Campaigns tab. Adding numbers from the Leads list needs the account owner.
- For Blacklist Alliance screening: a plan that includes TCPA litigator lookup (Growth, Pro, Ultimate, Velocity, Turbo, Hyper or BYOI, or any plan with Managed Floor Enterprise), your own Blacklist Alliance account and API key, and either the account owner or a team member with Trunks tab changes and the Server settings power.
Step 1: Check do-not-call is on for each campaign
- On the Campaigns tab, click your campaign and open DNC & Drop Actions.
- Use internal DNC checks your server-wide list before every call. Keep Yes (recommended).
- Use campaign DNC checks a list that belongs to this campaign only, useful when one client’s suppression list must not affect other campaigns. Keep Yes.
- If you changed anything, click Save N changes.
New campaigns have both switched on.

Step 2: Add numbers to do-not-call
- Agents: when an agent picks a result flagged DNC (such as DNC), the number goes on the list. See Call results (dispositions).
- Managers: on the Lists tab, Leads pill, tick leads and click Add to DNC (account owner only). Choose System-wide DNC (vicidial_dnc) or Campaign DNC only. See Find, edit or add a lead.
- When importing: under Do Not Call (DNC), keep Skip - don’t insert (recommended) so numbers already on your list never enter a new list.
Step 3: Open the TCPA compliance defaults
- Open your server and click the Trunks tab.
- Click the Compliance defaults pill.
This is the server-wide Blacklist Alliance setup. Every phone line (trunk) set to inherit it is screened. A badge shows Connected or Not configured, with a count of how many lines inherit, use their own key, or are switched off. If your plan does not include screening, the panel says "TCPA litigator lookup isn’t on this plan".

Step 4: Connect your Blacklist Alliance key
- Paste your key into Blacklist Alliance API key. You find it in your Blacklist Alliance dashboard under API Access. It is stored encrypted and never shown again; leave the box blank later to keep it.
- BA customer ID (optional): only if your Blacklist Alliance account needs one.
- On lookup failure: what happens if Blacklist Alliance can’t be reached. Allow call (fail-open · higher availability), the default, keeps dialing; Block call (fail-closed · stricter compliance) refuses the call. Numbers that are on the list are always refused.
- Leave Enabled on and click Test + save. The key is tested before it is saved.
From now on, each number is checked just before it is dialed, with a 2.5-second limit so dialing never stalls. Results are remembered for 6 hours per number, so redials don’t trigger a new lookup.
Step 5: Change it for one phone line (optional)
- On the Trunks pill, click a phone line to open it, then its Compliance (TCPA) section.
- Pick Inherit server default (the default), Custom (its own BLA API key, Customer ID and On upstream failure), or Disabled for lines outside US TCPA scope, such as Canada or the EU.
- Click Save compliance settings.
The list of lines flags problems: TCPA off on a disabled line, TCPA: add key on a Custom line with no key, and a red banner when outbound lines are dialing without screening.
If something goes wrong
Frequently asked
- The key was refused or could not be checked. Copy it again from your Blacklist Alliance dashboard, make sure nothing was cut off, and click Test + save.
- You need changes on the Trunks tab plus the Server settings power. Ask the account owner to update your access in Members.
- Screening is not part of your current plan. See "Change your plan or add-ons".
- Click Disconnect on Compliance defaults and confirm. Lines that inherit the default are no longer checked; lines set to Custom keep using their own key. To skip one line only, set it to Disabled.
- That isn’t available in the dashboard. Ask us in the chat.
› It says "Key test failed".
› It says "You do not have permission to change TCPA settings."
› The panel says "TCPA litigator lookup isn’t on this plan".
› How do I stop screening?
› How do I take a number off the do-not-call list?
Related articles
Tags: compliance, trunks, tcpa, blacklist-alliance


