Quick Reference
hopper_level
What Hopper Level Does
The target number of leads maintained in the dialing hopper (queue) at any given time. VICIdial continuously refills the hopper from your lead lists to maintain this count. Setting too low causes the dialer to pause while hopper is refilled; too high consumes memory and may lock in stale leads.
Recommended Configuration
| Center Size | Recommended Value | Notes |
| --- | --- | --- |
| 10–25 Agents | 20 to 200 depending on agent count and lead volume | Start conservative, monitor for 48 hours before adjusting |
| 25–100 Agents | 20 to 200 depending on agent count and lead volume | Scale gradually — larger operations amplify effects of misconfiguration |
| 100–500 Agents | 20 to 200 depending on agent count and lead volume | Consult ViciStack optimization team for enterprise-scale tuning |
How to Change This Setting
-
Navigate to Admin > Campaigns
-
Select campaign
-
Find Hopper Level field
-
Enter target hopper size (agents * dial_level * 2-3x buffer is a good formula)
-
For 20 agents at dial level 2: 80-120 is appropriate
-
Submit
Common Problems
Value too low (under 10) causes frequent hopper-empty pauses in dialing
Value too high locks leads in hopper that could be recycled sooner
Hopper not refilling despite leads in list indicates a dial_status_filter mismatch
ViciStack Module
ViciStack’s List Management & Optimization module automatically monitors and optimizes hopper_level 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 hopper_level do in VICIdial? +
The target number of leads maintained in the dialing hopper (queue) at any given time. VICIdial continuously refills the hopper from your lead lists to maintain this count. Setting too low causes the dialer to pause while hopper is refilled; too high consumes memory and may lock in stale leads.
What is the recommended value for hopper_level? +
The recommended range for hopper_level is 20 to 200 depending on agent count and lead volume. The out-of-box default is 20. 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 hopper_level for me? +
Yes. ViciStack's List Management & Optimization module monitors hopper_level 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 Blog Posts
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 →