CHATBOT
Chatbot troubleshooting
Common integration issues and fixes.
Widget not showing
- Script blocked by CSP — allow script-src from CDN.
- JavaScript error before widget init — check console.
- Missing data-public-key or data-bot-id.
401 invalid key
- Key revoked or wrong pk_live value.
- public_widget key not bound to botId in use.
403 domain not allowed
- Add exact page origin host to environment allowedDomains.
- Subdomains are not matched unless listed (strict mode on internal tenants).
429 rate limited
Too many sessions/messages per visitor or tenant — upgrade plan or reduce traffic.
Fallback replies only
- Low confidence — add knowledge or tune intent keywords.
- Bot not published.
Private action loops login
- setSessionToken not called after login.
- BFF not using secret_server for authenticated session.
Webhook signature mismatch
Wrong secret, clock skew, or body altered before verify.
No analytics
- Messages sent on wrong botId/environment.
- Filters on analytics date range.