Troubleshooting

Common issues and how to resolve them.

Common issues

Widget not loading

Check the script tag is present and the public key is correct. Open the browser console for a blocked-request error.

Domain not allowed

Add your site's domain to the allowed domains list in your environment settings.

Invalid public key

Confirm you're using the widget key (starts with pk_), not the secret server key.

Bot not published

Bots must be published before the widget or API will serve responses — check the bot's status in the dashboard.

Session expired

Authenticated sessions expire after a period of inactivity; start a new session to continue.

Usage limit reached

You've hit your plan's included usage. Switch to pay-as-you-go or upgrade your plan.

Payment / subscription issue

Check your billing details in the tenant dashboard, or contact support if a charge failed.

API rate limit

You're sending requests faster than your plan allows — add backoff/retry logic.

Still stuck?

Reach out — our support team can help with integration and billing questions.

Check the browser console

Most widget errors surface as console errors. Open DevTools and reload the page to see any blocked-request or invalid-key messages.

Verify the script tag

Confirm the script src is correct and the data-key attribute is present with a valid pk_ key.

Check allowed domains

Open your environment settings and confirm your exact domain (including https://) is in the allowed domains list.

Check bot status

In the dashboard, navigate to your bot and verify its status shows as Published.

Check usage dashboard

If responses stop abruptly, check your usage dashboard — you may have hit your plan limit.

Test in an incognito window

Browser extensions can interfere with widget loading. Test in an incognito window to rule them out.

invalid_keyThe API key is malformed or doesn't exist.

domain_not_allowedThe request origin isn't in the allowed domains list.

bot_not_publishedThe referenced bot is in draft state — publish it first.

session_expiredThe session token has expired — start a new session.

usage_limit_exceededPlan usage limit reached — upgrade or enable PAYG.

rate_limit_exceededToo many requests — implement backoff and retry.

Our support team can help with integration and billing questions.