Chat errors & troubleshooting
Common Chat integration issues.
- Widget does not load — check visitor origins include your site URL (scheme + host + port).
- CORS / blocked API — visitor calls must originate from a listed visitor origin or APP_URL pop-out.
- save-visitor 401 — use Authorization: Bearer {chatApplicationSecret}, not the widget key.
- Unknown custom field key — align save-visitor customFields with Pre-chat field keys in the dashboard.
- Agent cannot log in — verify agent is assigned to the application and password is correct.
- Agent embed blank — add your admin URL to agent origins.
- Plan limit reached — upgrade CHAT plan or reduce applications/agents.
API responses use { success, data } or { success: false, error: { code, message } }.