Troubleshooting
Common embed and widget issues.
Widget does not appear
- Confirm chatbotId in OthegoConfig matches the bot in your dashboard.
- Check the browser console for [Othego] warnings or network errors.
- Verify the chatbot is enabled (Settings → Chatbot enabled).
- On the free plan, only your oldest enabled bots may serve traffic if you exceed plan limits — upgrade or pause other bots.
- Ensure your domain is on the allowlist if you configured one.
window.OTHEGO is undefined
The API is attached after the widget mounts. Defer your calls until load (see the safe load check in the Widget API guide) or bind buttons after DOMContentLoaded.
Stale appearance or answers
Hard-refresh the page (or clear cache) after changing appearance or knowledge base. CDN caches may briefly serve an older chatbot.js; the widget always fetches fresh bot config from the API using your slug.