Skip to content

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

  1. 1Add your domainWhere it runs
  2. 2Style itWhat visitors see, Look
  3. 3Save
  4. 4Paste the snippetbefore </body>
  1. Open the agent, then Deploy.
  2. Under Where it runs, list your Allowed domains, one per line: example.com, or *.example.com for every subdomain. The widget runs nowhere until you add one. This stops others from putting your agent, and your credits, on their site.
  3. Adjust what visitors see (below) and select Save widget settings. The Preview shows the result.
  4. Copy the embed snippet and paste it before </body> on every page that should show the bubble:
html
<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

SettingWhat it does
Allowed domainsThe only sites the widget may appear on
Hosted help pageTurns on the agent's own page at /help/<agent-id>
Shown to N% of visitorsBelow 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 muchEach 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

SettingWhat it does
Open by itself after (seconds)Opens the chat once per visit; blank never opens it by itself
Thumbs up and down on repliesLets visitors rate answers, which you then see in Analytics
Copy button on repliesLets visitors copy an answer
Visitors can delete their conversationsGives visitors a delete option
Only verified visitorsRefuses 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.

GuardrailDefaultWhat it does
Pause spam conversationsOnChecks 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 messagesOffStops abuse, hate, sexual or violent content, and requests for something dangerous
Stop attempts to override instructionsOffStops messages that try to change the agent's role or reveal its instructions
Only talk aboutBlank (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

Something not working as described here? See Troubleshooting.

Get started free — 50 credits a month