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
2. Chat widget (recommended)
Add a chat launcher 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 | ></script> |
The widget adds a round launcher button in the corner of the page, with a sparkle to show it's an AI assistant. Clicking it opens the chat. The launcher uses your brand colour from Agent → Theme & branding, or a dark grey if you haven't set one, and picks a white or dark icon so it stays legible.
Configuration attributes:
data-colour— use a different colour from your brand colour (any CSS colour)data-icon—"chat"shows a chat bubble instead of the sparkledata-position—"right"(default) or"left"data-start-open— auto-open the chat panel on page loaddata-start-hidden— hide the launcher until you show it withwindow.__lexeyWidget.show()
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 Channels → Embed & share, 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-placeholder="Search..." |
| 5 | data-popup="center" |
| 6 | ></script> |
Configuration attributes:
data-colour— colour for the search button (default: your brand colour, or dark grey if you haven't set one)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 bar uses your website's font, so it fits into your page. It works well in website headers, help centres and knowledge base pages.
Chat slug
The last part of your chat address is your chat slug. Admins can change it in Channels → Embed & share → Chat slug. A slug uses lowercase letters, numbers and hyphens, and is 4–60 characters long. Changing it breaks links and embeds that use the old slug, so the portal asks you to confirm.
Domain allowlisting
Restrict which websites can embed your chat by adding up to 20 domains in Channels → Embed & share → Allowed domains (admins only), or by asking Lexey. An empty list allows embedding from any domain.
Links in chat answers that point to an allowed domain open straight away in a new tab. Links to any other site ask the customer to confirm first. Each domain matches exactly: https://example.com does not cover https://help.example.com, so list every site you link to.
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 on by default, and admins can turn it off in Channels → Embed & share → Bot protection.