Website widget and help page
Put an agent on your site with one script tag, style it and set its guardrails.
On this page
The website widget puts your agent on your site as a chat bubble in the corner. The help page gives the same agent a page of its own, to link from emails, a footer or a QR code. Both are set up on the agent's Deploy tab.
Put the agent on your site in four steps
- 1Add your domainWhere it runs
- 2Style itWhat visitors see, Look
- 3Save
- 4Paste the snippetbefore </body>
- Open the agent, then Deploy.
- Under Where it runs, list your Allowed domains, one per line:
example.com, or*.example.comfor every subdomain. The widget runs nowhere until you add one. This stops others from putting your agent, and your credits, on their site. - Adjust what visitors see (below) and select Save widget settings. The Preview shows the result.
- Copy the embed snippet and paste it before
</body>on every page that should show the bubble:
<script async src="https://app.ikazebot.com/embed.js" data-agent-id="YOUR-AGENT-ID"></script>
That is all. The script is tiny (about 3.5 KB), loads without slowing your page, and cannot be affected by your site's CSS. Copy the exact snippet from the Deploy tab, because it already contains your agent's id.
Using WordPress, Webflow, Wix, Shopify or similar? Paste the snippet wherever your platform lets you add code to the end of every page. It is often called "custom code", "footer scripts" or "code injection".
Settings
Where it runs
| Setting | What it does |
|---|---|
| Allowed domains | The only sites the widget may appear on |
| Hosted help page | Turns on the agent's own page at /help/<agent-id> |
| Shown to N% of visitors | Below 100% shows the bubble to a fixed share of browsers, for a gradual rollout or an A/B test |
| Message when a visitor sends too much | Each visitor may send 10 messages a minute. This is what they see after that. |
What visitors see
Display name (blank uses the agent's name), Message box placeholder, Initial messages (the greeting), Suggested messages (quick starts the visitor can tap), Footer, and Language. The widget comes in English and French. Automatic follows the visitor's browser or your page's lang attribute.
Look
Accent colour, Theme (automatic, light or dark), corner roundness, Font (system, serif or rounded), Bubble position (bottom right or left) and Bubble icon (chat bubble, question mark or sparkles).
Behaviour
| Setting | What it does |
|---|---|
| Open by itself after (seconds) | Opens the chat once per visit; blank never opens it by itself |
| Thumbs up and down on replies | Lets visitors rate answers, which you then see in Analytics |
| Copy button on replies | Lets visitors copy an answer |
| Visitors can delete their conversations | Gives visitors a delete option |
| Only verified visitors | Refuses anyone your site has not signed in, for customer-only support. See identity verification. |
Guardrails
Guardrails protect your agent and your credits. Checks never cost credits.
| Guardrail | Default | What it does |
|---|---|---|
| Pause spam conversations | On | Checks a visitor's 2nd, 4th, 8th and 16th messages. A spam conversation is paused and waits in the Inbox until someone resumes it. Nothing is charged meanwhile. |
| Stop harmful messages | Off | Stops abuse, hate, sexual or violent content, and requests for something dangerous |
| Stop attempts to override instructions | Off | Stops messages that try to change the agent's role or reveal its instructions |
| Only talk about | Blank (any topic) | For example "Our shoes, orders, delivery and returns". Messages clearly about something else are stopped. |
You can also write the replies shown when a check stops a message and while a conversation is paused.
The help page
Turn on Hosted help page, and the Deploy tab shows its address (https://app.ikazebot.com/help/<agent-id>). It is the same agent, settings and knowledge as the widget, on a full page. Share it in emails, social profiles, receipts or as a QR code in your shop.
Next
- Control the widget from your own code, or recognise signed-in customers: Widget JavaScript and identity.
- See every conversation as it happens: Inbox.
Related
- Widget JavaScript and identityControl the widget from your page, listen to its events and verify signed-in users.
- Inbox and human takeoverWatch conversations live, take one over, reply, write internal notes and hand back.
- TroubleshootingWhat to check when the widget does not show, an agent cannot answer, training fails or a channel is silent.
Something not working as described here? See Troubleshooting.