What happens when a direct-agent call has no one to answer

When a call is routed directly to one Agent via a DID (direct inward dialing) set to DID Route AGENT, it waits in an AGENTDIRECT Ingroup for that specific person to pick up. If the Agent does not answer before the in-group's drop timeout, VICIdial looks at the User Unavailable Action field on the DID record and acts on it — most commonly sending the call to the agent's voicemail box.

The three User Unavailable Action options

VICIdial gives you three choices for what to do when the drop timeout fires:

• VOICEMAIL — sends the call to the voicemail box specified in the Voicemail Box field on the DID record. The caller hears a greeting and can leave a message. This is the most common choice for personal direct-dial numbers.
• In-group — routes the call to a different in-group instead, putting it into a general queue where any available agent can answer. Use this when missing the call entirely is not acceptable and you need a backup team.
• Extension — sends the call to a raw Extension in the dialplan. This is the most flexible option: it can trigger an IVR, a hunt group, a ring-all group, or any other dialplan logic your server supports.

Call state from ring to resolution

stateDiagram-v2
  [*] --> Ringing: DID Route AGENT fires
  Ringing --> WaitingInQueue: Call enters AGENTDIRECT
  WaitingInQueue --> Connected: Agent in READY answers
  WaitingInQueue --> Timeout: Drop timeout reached
  Timeout --> Voicemail: User Unavailable Action is VOICEMAIL
  Timeout --> AlternateQueue: User Unavailable Action is in-group
  Timeout --> Extension: User Unavailable Action is extension
  Connected --> [*]
  Voicemail --> [*]
  AlternateQueue --> [*]
  Extension --> [*]

When is the agent considered unavailable

An agent is treated as unavailable for the purposes of this timeout if they are not logged in at all, if they are logged in but PAUSED, or if they are on another call and cannot accept inbound work. The AGENTDIRECT queue keeps checking until the drop timeout runs out. A PAUSED agent who returns to READY before the timeout is reached will still receive the call — the voicemail or fallback only fires if the timeout expires with the agent still unreachable.

Watching calls wait in the Real-Time Report

If you suspect a call is stuck waiting — or you want to confirm the timeout is working — open the Real-Time Report while the test call is in progress. The call appears in the queue column for the AGENTDIRECT in-group. You can watch the wait time count up until either the agent answers or the timeout fires and the User Unavailable Action takes over. This is also useful when the agent is not logged in: the call sits visibly in queue rather than silently disappearing.

For the full step-by-step DID setup that feeds into this timeout logic, see what the AGENTDIRECT in-group does. The remote agents and mobile guide covers how direct-to-agent routing fits into a full inbound setup. If you want a managed VICIdial server where voicemail and DID routing work out of the box, our plans get you a running dialer in under 40 seconds.