Skip to main content

​
Overview

The website widget is a floating chat bubble that visitors click to start a conversation with your AI agent. It runs entirely in the browser — no server-side setup needed on your website.

​
Configure the widget

Go to your agent’s Settings → Widget page to configure:
The widget won’t load if the domain allowlist is empty. Add at least one domain (e.g., yourdomain.com).

​
Embed the widget

Copy and paste this script tag before the closing </body> tag on your website:
Replace YOUR_AGENT_ID with your agent’s ID from the widget settings page. The widget appears as a floating button in the bottom-right corner.

​
Direct iframe

For more control over placement, embed the chat directly in an iframe:

​
How the chat works

  1. Session creation — When a visitor opens the chat, a session is created with a unique visitor token stored in localStorage
  2. Message exchange — The visitor sends a message, and the AI responds based on your prompt script
  3. Appointment booking — If the agent has a calendar integration, it can check availability and book appointments
  4. Session continuity — Returning visitors resume their previous conversation

​
Rate limits

To prevent abuse, the widget enforces these limits: When rate limits are hit, the widget shows a “sending too quickly” message. If the AI takes too long to respond (over 30 seconds), a timeout fallback message is displayed.

​
Lead limits

Each plan has a monthly lead limit. When your organisation’s limit is reached, new sessions start with AI disabled — the agent won’t respond automatically. Upgrade your plan or wait for the next billing cycle.