Guide
When it is not working
In the order these actually happen.
Nothing appears on the page
Open the browser console. A blocked or failed script says so there and is invisible in the page itself.
- Blocked by CSP. The console names the directive. See embedding for the three you need.
- The tag is on one page only. Pasted into a post or a single block rather than the site-wide footer.
- The tag never rendered. Some editors strip
<script>from rich-text fields. View source and check it is really there.
It appears, but says the site is not authorised
The domain you are on is not in the allowlist. The commonest cause is www.: example.com and www.example.com are different origins and both need listing. A staging or preview domain is a third.
Also check the key is the current one. Rotating a key takes effect immediately, so an old embed keeps sending a key that no longer exists.
It answers, but the answer is wrong
Check Context first. Ask the same question, then read what you supplied: if the answer is not there in plain words, the bot did not have the fact it needed.
Add the missing fact, or add a Guardrail telling it to say when it does not know and offer a way to contact you. Save the draft, Preview, then Publish; only published prompt changes affect visitors.
It refuses things you want it to answer
Usually a Guardrail written more broadly than intended. "Never discuss pricing" will also refuse "roughly what does a callout cost" — which is the question most visitors came to ask. Narrow it: "Never quote a fixed price without an inspection, but do give the standard hourly rate."
It stopped replying entirely
Check the month's count in the portal. Reaching either the daily safety ceiling or monthly allowance pauses replies by design, so the bill stays flat. The daily window clears first; moving up a plan raises both limits.
Replies are slow
A few seconds is normal; the reply streams as it is written, so it starts appearing before it is finished. Consistently much slower than that is worth telling us about — it usually means something on our side, not yours.
Still stuck
Ask the agent on this page. It knows these guides. If it cannot help, email hello@kavilo.cloud.