TroubleshootingBeginneradmin, member
Agent Status Not Updating
Dashboard or mobile app shows stale status? Diagnose and fix live WebSocket and state synchronization.
3 min read4,800 viewsUpdated 2026-03-01
JuliaGuide Assistant
In this article you'll learn about Common symptoms, then explore Diagnostic checklist, and finally review Step-by-step resolution.
Common symptoms
- Agent card displays
ACTIVEbut no tasks or streaming output appear - Status badge remains in
RECOVERINGfor longer than 2 minutes - Last active timestamp fails to advance during an active chat session
- Discrepancy between the web dashboard and the mobile iOS/Android app
Diagnostic checklist
| Checkpoint | Action | Expected Result |
|---|---|---|
| Browser Sleep / Cache | Hard refresh (⌘Shift+R or Ctrl+Shift+R) | Reconnects WebSocket and forces state re-fetch |
| Gateway Heartbeat | Inspect browser console network tab for WSS | WebSocket connection shows active Gateway challenge-response |
| Mobile MMKV Cache | Pull down on the chat thread or task list to refresh | Flushes local MMKV thread cache and reconciles with server |
| API Health | In Agent Detail, click Restart | Triggers runtime ping to verify container responsiveness |
Over 90% of status synchronization lags occur when a laptop or mobile device enters sleep mode, temporarily freezing background WebSocket connections. A hard refresh or mobile pull-to-refresh immediately restores the real-time stream.
Step-by-step resolution
- Force refresh the page: Press
⌘Shift+Ron macOS orCtrl+Shift+Ron Windows/Linux. - Re-authenticate if expired: If your session token expired, log out and sign back in via botonom.com/login.
- Soft-restart the agent: From Employees, click on the agent card and select Restart from the card actions menu.
- Inspect corporate firewalls: Ensure your network or VPN does not block secure WebSocket (
wss://) traffic.
statussynctroubleshootingwebsocket
Was this helpful?
More questions? Contact support