VICIdial Error: Hopper Empty — Cause & Fix

Error Summary

Error Message

Hopper Empty

Severity

Critical

Component

Web

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. 1
    Check current hopper status in VICIdial real-time report
  2. 2
    Run SQL to count leads by status: SELECT status, COUNT(*) FROM vicidial_list WHERE campaign_id='CAMPAIGN_ID' GROUP BY status
  3. 3
    Verify that lead statuses in the results are included in dial_status_filter
  4. 4
    If statuses mismatch, update dial_status_filter to include available statuses
  5. 5
    Enable or expand lead_recycling if appropriate statuses exist but recycling isn't configured
  6. 6
    If the list is genuinely exhausted, upload new leads or create a new list
  7. 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.

Critical Campaign Dial Level Zero Web Critical List Not Loading Web

Still Stuck?

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.

Get Free VICIdial Support →

Frequently Asked Questions

What causes the VICIdial "Hopper Empty" 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 do I fix the VICIdial "Hopper Empty" error?
Check current hopper status in VICIdial real-time report Then: Run SQL to count leads by status: SELECT status, COUNT(*) FROM vicidial_list WHERE campaign_id='CAMPAIGN_ID' GROUP BY status Then: Verify that lead statuses in the results are included in dial_status_filter Then: If statuses mismatch, update dial_status_filter to include available statuses Then: Enable or expand lead_recycling if appropriate statuses exist but recycling isn't configured Then: If the list is genuinely exhausted, upload new leads or create a new list Then: Check hopper refill is running: review vicidial_log for auto-hopper-fill entries
How can I prevent the "Hopper Empty" error in VICIdial?
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.