Troubleshooting

VICIdial Error Database

Step-by-step fix guides for every VICIdial error. Find your error, follow the commands, and get back online — written by engineers who've fixed thousands of VICIdial installs.

Severity:
Component:
25 errors
Critical Web

Phone Login Not Active

Agent is attempting to log in but the phone extension or SIP account is not registered with Asterisk. Can occur when the...

View fix guide →
Critical Asterisk

Asterisk Not Running

The Asterisk process has stopped or crashed. This causes complete failure of all call processing — no outbound calls can...

View fix guide →
Warning Web

Time Synchronization Error

The VICIdial server's system clock is out of sync with NTP time servers. This causes issues with scheduled callbacks, ti...

View fix guide →
Critical Web

Campaign Dial Level Zero

The campaign's dial level has been reduced to zero — either manually by an administrator, automatically by the adaptive ...

View fix guide →
Critical Web

Hopper Empty

The VICIdial lead hopper has no leads remaining for dialing. The campaign will stop placing outbound calls. Causes inclu...

View fix guide →
Critical Web

Agent Screen Blank

The VICIdial agent interface displays a blank white or black screen. Causes include: VICIdial web server (Apache/Nginx) ...

View fix guide →
Warning Asterisk

Recording Not Starting

Call recordings are configured in the campaign but not being created. Common causes: recording directory doesn't exist o...

View fix guide →
Critical Web

WebRTC Connection Failed

The browser-based WebRTC softphone cannot establish a connection to the Asterisk server. Causes include: WSS (WebSocket ...

View fix guide →
Critical Asterisk

SIP Registration Failed

A SIP peer (agent softphone, carrier trunk, or remote extension) is failing to register with the Asterisk server. Common...

View fix guide →
Critical Database

Database Connection Lost

VICIdial cannot connect to the MySQL/MariaDB database. This causes complete system failure — no calls can be placed, no ...

View fix guide →
Critical Network

Carrier Trunk Full

All concurrent call channels on the outbound carrier trunk are in use. New outbound calls are being rejected with 503 Se...

View fix guide →
Warning Web

CID Not Set

The outbound caller ID has not been configured for the campaign. VICIdial is attempting to place calls without a valid c...

View fix guide →
Critical Web

List Not Loading

A lead list assigned to a campaign is not populating the hopper with leads. Possible causes: the list status is set to i...

View fix guide →
Warning Web

Callback Not Firing

Scheduled callbacks are not being dialed at their configured times. Causes include: VICIdial cron job (vicidial_callback...

View fix guide →
Warning Asterisk

Transfer Failed

An agent attempted to transfer a call and the transfer failed or dropped. Causes include: target transfer destination (i...

View fix guide →
Critical Network

Audio One Way

The call is connected but audio only flows in one direction — either the agent can't hear the caller or the caller can't...

View fix guide →
Warning Asterisk

DTMF Not Working

DTMF tones (keypad presses) are not being detected or transmitted correctly. Agents pressing keys during IVR navigation ...

View fix guide →
Warning Web

Agent Kick All Error

The 'Kick All Agents' function in VICIdial admin triggered an error. This function forces all agents offline and is used...

View fix guide →
Critical Asterisk

Dial Prefix Invalid

The configured dial_prefix or force_dial_prefix is causing all outbound calls to fail. The combined prefix + phone numbe...

View fix guide →
Warning Asterisk

Queue Overflow

An inbound queue has more callers waiting than can be serviced in a reasonable time, or the queue depth exceeds the maxi...

View fix guide →
Warning Asterisk

AMD Timeout

The Asterisk AMD application is taking too long to make a human/machine determination and timing out before a decision i...

View fix guide →
Critical Web

VICIdial Process Not Running

The VICIdial background daemon processes (VDaemon, AST_manager, or hopper scripts) have stopped. These processes handle ...

View fix guide →
Warning Web

Screen Pop Blank

The agent's screen pop (the web page that loads when a call connects, usually a CRM record or lead form) is showing blan...

View fix guide →
Warning Web

API Authentication Failed

A VICIdial API call (from an external CRM, reporting tool, or integration) is failing authentication. Causes include: ex...

View fix guide →
Warning Database

Report Timeout

A VICIdial report is timing out before completing. Reports that query large datasets (call logs, agent performance, or l...

View fix guide →