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.