What a VICIdial lead filter is and why you'd use one

A Lead filter is a reusable rule that narrows which leads your dialer is allowed to call. Instead of dialing every record on a list, the filter quietly trims the pool down to the leads you actually want right now. Under the hood it is a small piece of SQL — a query fragment — that the dialer attaches to the lead pull. You write the rule once, give it a name, and then point a campaign or a user at it.

Think of a Lead list as the whole bucket of records you loaded, and a Filter as a sieve sitting on top of it. The records are still there; the filter just decides which ones fall through into the dialing queue. Nothing is deleted, and the same list can be dialed wide open by one campaign and tightly filtered by another. That reuse is the point — a single well-written filter can serve several campaigns without you copying the rule into each one.

Where a filter gets applied

You can attach a filter in two places. The first is the campaign: every record the Campaign pulls into the Hopper gets the filter rule added, so the whole agent team dials the narrowed pool. The second is the individual user — a single agent can carry their own filter on top of, or instead of, the campaign one. That lets you keep one campaign while still steering different agents at different slices of the same leads.

Because the filter is applied at pull time, it does not change anything permanent. Turn it off and the full list is callable again on the next load. That makes filters safe to experiment with — the worst case is too few leads in the hopper, which you catch before going live.

How the dialer uses the filter

flowchart TD
  A[Lead list loaded] --> B[Campaign or user has a filter]
  B -->|Yes| C[Filter SQL trims the pool]
  B -->|No| D[Whole list is eligible]
  C --> E[Matching leads enter the hopper]
  D --> E
  E --> F[Dialer calls from the hopper]

When the hopper-loading job runs, it takes your filter rule and tacks it onto the query that selects callable leads. Only the records that satisfy the rule make it into the hopper, and only hopper records get dialed. That is the whole mechanism — the filter never changes a lead, it just changes whether that lead is eligible on this pull.

Why operators reach for filters

There are a handful of common reasons. Lead penetration is the big one: you might want to call only fresh leads first, or only records under a certain call count, so you work the easy contacts before grinding the rest. Compliance windows are another — filtering by state or time zone keeps you inside legal calling hours. And filters are handy for A/B testing, where you split leads by Lead source and run two slices side by side to see which converts better.

• Penetration: dial only fresh leads, or only those under a call-count threshold.
• Compliance: restrict to certain states or regions to respect calling-hour rules.
• Testing: split by source or Vendor lead code to compare two slices of the same list.

Filters are one of the quieter levers in VICIdial, but they shape every call your team makes. If you are weighing them alongside scorecards and reviews, the quality-control guide shows how the pieces fit together, and the QC setup walkthrough covers the wider call-quality picture filters live in.

VICIfast runs a managed VICIdial box where filters, campaigns, and the hopper are all ready to configure from day one, live in under 40 seconds. See our plans and pricing.