Callers stuck on hold forever: common causes

A caller sits on hold and waits, and waits, while an agent appears to be free. Inside a VICIdial Ingroup (the inbound group queuing calls for agents) there are a few settings that quietly keep a caller from being handed off, even when the queue logic is otherwise healthy. Most of them come down to one thing: a prompt is playing, and while it plays the caller cannot be sent anywhere.

The welcome message blocks the queue

The Welcome Message Filename plays when a call arrives, and the caller does not actually enter the queue to be sent to an agent until that message finishes. A long welcome clip means a guaranteed wait before anyone can be matched. A common fix is to drop the welcome file and instead put any greeting at the start of the Music on hold, because hold music can be interrupted to send a caller to an agent the moment one is free.

On-hold prompts hold the caller in place

The On Hold Prompt is that periodic recorded line, like a please-keep-holding message. While it plays, the caller cannot be sent to an agent. The On Hold Prompt No Block setting fixes part of this by letting callers behind the one hearing the prompt move to agents, but the caller actually hearing it still waits until it ends. The same blocking behavior applies to the Estimated hold time prompt and to the wait-time press prompts.

flowchart TD
  A[Caller in queue] --> B{Is a prompt playing}
  B -->|Welcome or on hold prompt| C[Caller cannot be sent to agent yet]
  C --> D[Wait for prompt to finish]
  B -->|Only music on hold| E[Can be sent the instant an agent frees]
  D --> F{Agent available}
  E --> F
  F -->|Yes| G[Connect to agent]

No agents, so the call just hangs

If No Agents No Queueing is set to N, calls queue up even when nobody is logged in to take them, and they wait indefinitely until someone appears. That is the right setting for some operations and a trap for others. If you would rather not strand callers, set it to NO_READY or NO_PAUSED so they are routed to the No Agent No Queue Action instead of holding forever for an Agent who is never coming.

Give long waits an exit

Even with everything set right, busy hours produce real waits. The Wait Time Option lets a caller press a key after a set number of seconds to leave the queue, and the callback queue option keeps their place in line while calling them back later instead of making them hold. Offering an exit is often better than letting a caller sit until they give up. You can also play an estimated hold time so the caller knows what they are in for, which on its own reduces how many people hang up frustrated.

If the problem is that calls never reach the queue at all, that is the related issue covered in inbound calls not reaching agents. The inbound call handling guide lays out the full queue flow.

Starting fresh helps. Our managed VICIdial hosting stands up a dialer with sensible queue defaults in under 40 seconds.