Quick Reference

Setting Name lead_filter
Default Value NONE
Recommended Configure based on campaign targeting needs
Impact Level High
Location Admin > Campaigns > [Campaign] > Lead Filtering
ViciStack Module List Management & Optimization

lead_filter

What Lead Filter Does

A SQL WHERE clause expression applied to lead records before they enter the hopper. Allows granular filtering by any lead field — state, zip, custom data fields, source, etc. This enables precise targeting without managing separate lead lists for each segment.

| Center Size | Recommended Value | Notes |

| --- | --- | --- |

| 10–25 Agents | Configure based on campaign targeting needs | Start conservative, monitor for 48 hours before adjusting |

| 25–100 Agents | Configure based on campaign targeting needs | Scale gradually — larger operations amplify effects of misconfiguration |

| 100–500 Agents | Configure based on campaign targeting needs | Consult ViciStack optimization team for enterprise-scale tuning |

How to Change This Setting

  • Navigate to Admin > Campaigns

  • Select campaign

  • Find Lead Filter field (or Lead Filter ID)

  • Create filter expressions in Admin > Lead Filters

  • Reference the filter ID in this field

  • Test with a small list before going live

  • Submit

Common Problems

Overly restrictive filters empty the hopper unexpectedly

SQL syntax errors in custom filters cause campaign to stop dialing

Filters not updating when lead data changes mid-campaign

ViciStack Module

ViciStack’s List Management & Optimization module automatically monitors and optimizes lead_filter based on real-time performance data from your operation. Instead of manual tuning, ViciStack continuously analyzes call outcomes, agent performance, and contact rates to recommend and implement optimal values — often catching configuration drift before it affects your numbers.

Frequently Asked Questions

What does lead_filter do in VICIdial? +

A SQL WHERE clause expression applied to lead records before they enter the hopper. Allows granular filtering by any lead field — state, zip, custom data fields, source, etc. This enables precise targeting without managing separate lead lists for each segment.

What is the recommended value for lead_filter? +

The recommended range for lead_filter is Configure based on campaign targeting needs. The out-of-box default is NONE. Note that optimal values vary by operation size, campaign type, and carrier — use ViciStack's automated tuning to find your exact optimal configuration.

Can ViciStack automatically optimize lead_filter for me? +

Yes. ViciStack's List Management & Optimization module monitors lead_filter continuously and alerts you when the value drifts outside optimal range. On qualifying plans, ViciStack can automatically adjust this setting based on real-time performance data — no manual intervention required.

Related Settings

dial_status_filter View setting → lead_order View setting → list_order View setting → manual_dial_filter View setting →

Related Blog Posts

Industry Insights Call Center ROI Formula: How to Calculate and Improve Read article → Technical Guides Migrating from GoAutoDial to VICIdial: Step-by-Step Read article → Product Updates Podcast Ep. 7: VICIdial Dial Hopper: How It Works and Why Yours Is Empty Read article →

Part of the Complete VICIdial Implementation Guide and VICIdial Performance Optimization Guide

Need Help Optimizing Your VICIdial?

Get a free performance audit from our team of VICIdial experts. We'll identify quick wins and long-term improvements.

Get Your Free Audit →