Quick Reference

Setting Name max_hopper_calls
Default Value 0
Recommended 0 (unlimited) or cap at 2x hopper_level
Impact Level Medium
Location Admin > Campaigns > [Campaign] > Dial Settings
ViciStack Module Dialer Tuning & Auto-Configuration

max_hopper_calls

What Max Hopper Calls Does

Sets an absolute maximum cap on the number of calls that can be simultaneously active in the hopper queue. This prevents memory and performance issues during peak dialing when adaptive dial level may push call volume very high.

| Center Size | Recommended Value | Notes |

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

| 10–25 Agents | 0 (unlimited) or cap at 2x hopper_level | Start conservative, monitor for 48 hours before adjusting |

| 25–100 Agents | 0 (unlimited) or cap at 2x hopper_level | Scale gradually — larger operations amplify effects of misconfiguration |

| 100–500 Agents | 0 (unlimited) or cap at 2x hopper_level | Consult ViciStack optimization team for enterprise-scale tuning |

How to Change This Setting

  • Navigate to Admin > Campaigns

  • Select campaign

  • Find Max Hopper Calls field

  • Enter 0 for unlimited or set cap value

  • Recommended cap: agents * max_dial_level * 3

  • Submit

Common Problems

Value of 0 on large operations can allow runaway dialing scenarios

Setting too low artificially throttles dial rate below optimal

Must be coordinated with hopper_level to avoid conflicts

ViciStack Module

ViciStack’s Dialer Tuning & Auto-Configuration module automatically monitors and optimizes max_hopper_calls 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 max_hopper_calls do in VICIdial? +

Sets an absolute maximum cap on the number of calls that can be simultaneously active in the hopper queue. This prevents memory and performance issues during peak dialing when adaptive dial level may push call volume very high.

What is the recommended value for max_hopper_calls? +

The recommended range for max_hopper_calls is 0 (unlimited) or cap at 2x hopper_level. The out-of-box default is 0. 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 max_hopper_calls for me? +

Yes. ViciStack's Dialer Tuning & Auto-Configuration module monitors max_hopper_calls 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

adaptive_dl_level View setting → auto_dial_level View setting → available_only_ratio_tally View setting → hopper_level View setting →

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 →