Agent screen blank or stuck on loading

Agent logs in but sees a blank agent interface or a spinner that never resolves.

Symptoms

•Agent interface loads to white screen or endless spinner
•Browser console shows 404 or 500 on AJAX endpoints
•Issue affects one agent, one browser, or all agents

Common causes

•Expired PHP session or stale cookie
•Asterisk Manager Interface (AMI) connection refused
•Missing PHP extensions (typically mysqli or curl)
•ChromeOS / browser cache holding old build

How to fix it

1
Clear the agent's browser cookies and cache, then re-login
2
Check `service asterisk status`, if down, start it
3
Tail `/var/log/asterisk/vicidial-agi.log` during login to see server-side error
4
Verify PHP error log shows the actual failure (often under `/var/log/httpd/error_log`)
5
If AMI refused, check `/etc/asterisk/manager.conf` credentials match `vicidial_host_options.asterisk_mgr_user/pass`

VICIPanel diagnostic for: Agent screen blank or stuck on loading — Web health and operational view in VICIPanel

How VICIPanel helps

VICIPanel's agent UI is a modern React app with explicit error boundaries, when something fails, the agent sees a specific error message with a copy-to-clipboard button, not a blank page. Supervisor view also flags agent-side errors in real time.

Related issues

More Web errors

Agent kick-all command errors out

Supervisor 'kick all agents' function errors instead of logging agents out.

API authentication failed

External system cannot authenticate to the VICIdial non-agent API.

Screen pop blank or showing wrong lead

When a call connects, the agent sees a blank lead form or data from a previous call.

Stop troubleshooting. Start operating.

VICIPanel's health dashboard catches most of these issues before they impact your agents — with plain-English diagnostics and one-click remediation.

Try the live demo Error reference