Hopper Empty

What Causes This Error

The VICIdial lead hopper has no leads remaining for dialing. The campaign will stop placing outbound calls. Causes include: all leads in the list have been dialed and dispositioned with statuses not in dial_status_filter, the dial_status_filter doesn’t match any available lead statuses, lead_recycling is not configured, or the lead list is genuinely exhausted.

How to Fix It

• 1 Check current hopper status in VICIdial real-time report

• 2 Run SQL to count leads by status: SELECT status, COUNT(*) FROM vicidial_list WHERE campaign_id=‘CAMPAIGN_ID’ GROUP BY status

• 3 Verify that lead statuses in the results are included in dial_status_filter

• 4 If statuses mismatch, update dial_status_filter to include available statuses

• 5 Enable or expand lead_recycling if appropriate statuses exist but recycling isn’t configured

• 6 If the list is genuinely exhausted, upload new leads or create a new list

• 7 Check hopper refill is running: review vicidial_log for auto-hopper-fill entries

How to Prevent It

Set up hopper level alerts when leads drop below a minimum threshold. Configure lead_recycling proactively. Monitor dial_status_filter vs. actual lead status distribution weekly. Upload new leads before current list is exhausted.

ViciStack’s free 30-day support plan includes unlimited live VICIdial troubleshooting. If you can’t resolve this error with the steps above, our engineers will connect to your system and fix it directly — no support tickets, no hourly billing.