What it is
The Chat Widget group has three pages: Chat Widget Dashboard (create up to three widgets, each an API key), Chat Widget Inbox (the conversations), and Floating Action Buttons (a bar of WhatsApp, Messenger, Instagram and Telegram buttons that can sit beside the widget).
Create a widget
- Chat Widget Dashboard → Create API Key. The subtitle shows how many of your three keys are used.
- Give it a Description and, ideally, your domain under Allowed Domains so the key works only on your site.
- Pick the Workflow (an AI flow) that answers visitors. Leave it empty to use your universal default flow.
- Set the greeting, theme, colour and logo, then Create API Key.
- Copy the embed code from the success dialog.
Settings explained
| Setting | Meaning |
|---|---|
| Allow Stop AI | Visitors can ask for a person, which pauses the AI in that chat. |
| Allow File Attachment | Visitors can send files. |
| Open on Load | The chat window opens as soon as the page loads. |
| Greeting | The first message. Defaults to "Hi there! How can I help you today?" |
| Session Inactivity Reset | After this idle time a returning visitor starts a fresh chat. Leave empty to never reset; 24 hours or more is recommended. |
| Floating Widget, Default Position | Whether visitors can drag the bubble, and which corner it starts in. |
| Theme, Primary Color, Gradient, Logo | Appearance. Use a square PNG with transparency for the logo. |
Keys can be revoked, reactivated and deleted from the card menu, and the key value is masked with a show/hide eye.
Turning visitors into leads
Under Visitor Information Mapping, enter the exact field keys your flow collects (see Collecting data), for example name and phone. The inbox then shows the visitor's name and number instead of Visitor #1234. Turn on Enable Lead Creation and a lead is created once both are collected and the phone has at least 8 digits.
Both fields are required for leads
Lead creation stays off until both a name field and a phone field are mapped. If the flow never collects them, or the phone is invalid, no lead is created and the visitor remains a chat only.
Add it to your site
Paste the code just before the closing </body> tag on every page. If your site knows who the visitor is, pass their id and name so chats are linked to your own records.
<!-- Chat Widget -->
<script>window.ChatConfig = { apiKey: 'YOUR_KEY' }</script>
<script src="…widget script url…"></script>
<!-- Optional: identify the visitor from your own system -->
<script>window.ChatConfig = { apiKey: 'YOUR_KEY', visitorId: 'user_12345', visitorName: 'John Doe' }</script>Answering widget chats
Chat Widget Inbox has a channel selector (which widget), a searchable conversation list, the chat with a composer that supports files, and a visitor panel showing the collected data with inline edit and delete. Pause the AI for a visitor from the chat when you want to take over.
Floating action buttons
On Floating Action Buttons, choose left or right, tick the platforms you want (WhatsApp with a wa.me link, Messenger, Instagram, Telegram), drag them into order, optionally include one of your chat widgets, and Copy Script. Paste it before </body>; it replaces the widget snippet because it includes the widget.