Embedding your chat

Lexey provides five ways to deploy customer chat on your website.

1. Hosted page

Direct link to your full-page chat experience:

https://lexey.ai/chat/your-company-slug

Share this URL with customers, add it to your website, or use it in email signatures. It's also useful for sharing with your team to see how Lexey responds before you go live.

2. Chat widget (recommended)

Add a floating chat bubble to your website with a single script tag:

1	<script
2	src="https://lexey.ai/embed/widget.js"
3	data-tenant="your-company-slug"
4	data-colour="#46B483"
5	data-position="right"
6	></script>

The widget creates a floating bubble that opens an iframe panel when clicked.

Configuration attributes:

data-colour — brand colour for the bubble (default: #46B483)
data-position — "right" (default) or "left"
data-start-open — auto-open the chat panel on page load
data-start-hidden — hide the bubble until shown via the JavaScript API

3. Iframe embed

Embed the chat inline on your page:

1	<iframe
2	src="https://lexey.ai/embed/your-company-slug"
3	width="400"
4	height="600"
5	style="border: none; border-radius: 12px;"
6	></iframe>

4. Email signature

Add a branded chat link to your email signature. Go to Settings → Embed, find the Email Signature card, and click the copy button. Then paste directly into your email client’s signature editor (Gmail, Outlook, Apple Mail). The rich formatting is preserved automatically — no need to paste raw HTML.

The signature includes your Lexey logo, agent name, and a link to your hosted chat page.

5. Search widget

Embed a search bar on your website. When a customer submits a query, a chat popup opens with the answer:

1	<script
2	src="https://lexey.ai/embed/search-widget.js"
3	data-tenant="your-company-slug"
4	data-colour="#46B483"
5	data-placeholder="Search..."
6	data-popup="center"
7	></script>

Configuration attributes:

data-colour — brand colour for the search button (default: your primary colour)
data-placeholder — placeholder text in the search input (default: "Search...")
data-popup — how the chat opens: "center" (modal overlay, default) or "corner" (bottom-right panel, less intrusive)

The search widget works great in website headers, help centres, and knowledge base pages.

Custom URL

You can update your organization-specific URL in Settings → Embed. Custom URLs must be lowercase alphanumeric with hyphens, 4–60 characters.

Domain allowlisting

Restrict which websites can embed your chat by configuring allowed domains (up to 20) via the configuration agent. An empty list allows embedding from any domain.

We recommend enabling domain allowlisting to ensure your credits are only used by conversations on your own websites.

Bot protection

All embedded chat surfaces are protected by Cloudflare Turnstile — a privacy-friendly, invisible bot verification. Turnstile checks happen once when the user sends their first message. It's enabled by default and can be toggled off in Settings → Embed → Bot protection.

We recommend leaving bot protection enabled to make sure only humans can start conversations with your agent via the embedded chat widget.