FAQ & troubleshooting
Quick answers to common questions and fixes for things that go wrong.
The widget doesn't appear on my site
- Hard-refresh: Ctrl/⌘ + Shift + R. Many site builders cache aggressively.
- Open DevTools (F12) → Console. Red errors mentioning
agenbotor your script URL usually pinpoint the cause. - Confirm the script tag is exactly what the dashboard shows, with the correct site key.
- If your site uses a Content-Security-Policy, allow scripts from
agenbot.vercel.app.
The AI isn't replying
- Open Settings → AI and confirm AI auto-reply is toggled on.
- Make sure your OpenRouter key is set in the project environment. The most common silent failure is a stale or revoked key.
- Check whether a human teammate has already replied in that specific conversation — once they have, the AI permanently stops talking in it. Start a fresh conversation to test.
- The AI might be in “handoff standby” — it keeps answering but won't escalate again. See AI agent.
The widget says “Online” but no one's actually online
Your availability mode is probably set to Always online. That's fine if the AI handles most chats — but if you want the badge to reflect real presence, switch to Realtime or Scheduled.
What counts as a teammate being “online”?
A teammate counts as online only when they have the inbox open in a browser tab or the PWA. Just being logged in doesn't count — neither does having the app installed but closed. Push notifications still reach them either way.
Push notifications aren't arriving
- On iPhone, you must install Agentbot to your home screen first. Notifications don't work in regular Safari tabs.
- Check OS-level settings: iOS → Settings → Notifications → Agentbot; Android → Settings → Apps → Agentbot → Notifications.
- In Agentbot, go to Settings → Notifications and confirm the device is listed and enabled.
- If a device is acting up, remove it and re-enable from scratch.
A teammate's invite email didn't arrive
Email delivery is optional — if you haven't configured Resend, the invite link is displayed directly in the dashboard. Copy it from the Pending invitations section of Settings → Team and send it however's easiest. The link is valid for 14 days.
How do I delete a conversation?
Conversations are kept for transcript history — you can't delete them through the UI. If you need a chat permanently removed for privacy reasons (e.g. GDPR request), contact us with the conversation ID and we'll handle it.
How long are uploaded files kept?
Chat attachments are deleted automatically 14 days after the last message in their conversation. The message text stays — only the attached file is removed. This keeps storage usage bounded and is good privacy hygiene.
Can I use a custom domain for the widget?
Yes, but it requires connecting a custom domain to the Agentbot deployment. Contact us if you want to swap agenbot.vercel.app for chat.yourbrand.com.
Does the widget work on mobile browsers?
Yes — same widget, just rendered full-width on small screens. Tested on iOS Safari, Android Chrome, and Samsung Internet.
Can the AI speak my language?
Yes. The AI replies in whatever language the visitor writes in. If you want a specific default (e.g. always reply in German even if the visitor writes in English), add that to your system prompt: “Always reply in German.”
I'm getting weird character encoding in replies
If emoji or non-Latin characters show as ? or □, your site is probably missing a UTF-8 charset declaration. Add this to your HTML <head>:
<meta charset="utf-8" />