FAQ and troubleshooting
Quick fixes for the most common questions.
The widget isn't showing on my site
Check the bot is Active, the <script> snippet is pasted before </body>, and the data-key matches the bot's public key. A paused bot shows a "paused" notice instead of answering.
The answers are vague or wrong
Train it on more content — Q&A sources are the most precise. Turn on "Answer only from trained knowledge" so it can't fall back on general knowledge, and set "What to help with" and "Topics to escalate".
Training says "no worker is running"
Training runs in the background. Click Run now on a source, or have your host run php artisan queue:work. WhatsApp replies also need a worker.
Why is search "keyword" instead of smart?
You haven't added an embedding key (OpenAI or Gemini). Add one under Settings › Provider API keys, then hit Retrain all to upgrade to semantic search.
It replied in the wrong language
"Auto-detect language" makes it reply in the visitor's language. For a random or gibberish message it stays in English rather than guessing.
WhatsApp messages aren't getting a reply
Confirm the webhook is verified and the messages field is subscribed in Meta, a queue worker is running, and you're within Meta's 24-hour window.
The bot never hands off to a human
Enable "Allow human takeover" and the "Autonomous agent" capability on the bot, and list the topics it should escalate. Visitors asking for "a person" are escalated automatically.
How do I keep AI costs down?
Use bring-your-own-key so you pay providers directly at cost, and pick an efficient model (a "mini"/"flash" tier) for high-volume bots.