Chats: add a chat widget to your website
What Chats does
A chat is a chat button you place on your website. When a visitor sends a message, Enydea opens a chat room that your team answers inside Enydea. The same chat can also receive WhatsApp messages. An AI agent can reply automatically, but that is optional and off by default.
The Chats screen is English-only in every app language.
Before you start
- Select a relation in Current Account in the sidebar. A chat is stored under that relation, and without one Enydea shows "No relation selected".
- To show the widget on your website you need to edit the page's HTML, or ask your web developer.
Create a chat and get the code
Chat Management with no chats yet. New Chat creates the first one.
- Click Chats in the sidebar.
- Click New Chat (or Create your first chat). The new chat is named "new".
- Type your own Chat Name. Visitors see it as the title of the chat window.
- Click Get Embed Code. A dialog titled Embed Chat Widget opens.
- Click Copy Code.
- Paste the code into your page's HTML, just before the closing
</body>tag, on every page that should show the chat.
The code looks like this, with your own chat ID:
<!-- Enydea Chat Widget -->
<script src="https://app.enydea.com/widget/enydea-chat.js"
data-chat-id="YOUR_CHAT_ID"
data-name="Your chat name"
data-color="#1976d2"></script>
data-name and data-color appear when the chat has them. Add data-position="left" to move the button to the bottom left. The window text follows your page's lang setting (English, Dutch, German or French).
Under Appearance Settings, Background Color is the widget's main colour. Text Color, Width, Height, Chat Avatar and Start Icon style the chat window you see inside Enydea. The website widget keeps its own size and icons. Embed Code Preview updates as you change settings.
Test the chat on your live site before you announce it. Send a message from your page. A new room should appear under Chat Rooms (reload Chats if it does not show yet). If the window opens but no room ever appears, the visitor sees no error, so contact support.
What visitors see
The chat window on a website.
- A round button at the bottom right. It opens a window with your Chat Name, an online or offline status, a welcome message ("Welcome! How can we help you today?") and a message box. You cannot change the welcome message on this screen.
- Four quick-reply buttons with fixed wording: "What do you offer?", "Pricing", "Contact sales" and "AI features". Clicking one sends that text as the visitor's message.
- A "Powered by Enydea" link at the bottom of the window.
Answer in Chat Rooms
Select a chat to see its Chat Rooms: visitor name, company if known, members and date.
A chat room opened from the Chat Rooms list.
- Each room shows a coloured dot ("Needs reaction") until an attendee is recorded on it. Replying does not record one, so expect the dot on every room. The bell icon (Show only rooms needing attention) filters by that flag. Filter rooms... searches, and the bin deletes a room.
- Click a room to open it, type your reply and press Enter. Rooms that came from WhatsApp show a WhatsApp badge.
- The person who created the chat gets a System Messages notification for every new conversation and visitor message. Ticking Chat notifications under Settings -> Account -> Notification Preferences adds push or email, as you set there.
AI Agent Settings (optional)
Tick Enable AI Auto-Reply to let the AI answer each visitor message. Your team still sees every message and can write in the room.
| Field | What it does |
|---|---|
| System Prompt | Instructions for the AI's personality and scope |
| Supported Languages | English, Dutch, German, French, Spanish, Portuguese, Italian. Empty means any language. |
| Include CRM Context | Lets the AI use company details, matching CRM records and opportunities. On for new chats. |
| Include Product Catalog | Lets the AI use products and services from your catalog. On for new chats. |
| Max History | Earlier messages the AI reads (20 for new chats) |
| Max Response Length | Characters. Longer replies are cut and end with "..." (500 for new chats). |
| Reply Delay | Milliseconds before the reply appears (1500 for new chats) |
Warning: AI replies go to the public. With Include CRM Context on, the AI can draw on your CRM when it answers. Switch it off if your CRM holds details visitors must not see.
If the AI service times out or is unavailable, the visitor gets a message that a team member will reply shortly.
Content filter
Enable Content Filter appears when AI auto-reply is on. It is on for new chats. Fill in Banned Words (comma-separated, wildcards with *), Banned Topics, or Allowed Topics (Whitelist). If you fill in the whitelist, only those topics are answered.
The filter works on AI replies only. If it blocks a visitor's message, the AI answers with a polite refusal. If it blocks the AI's own draft, a generic apology is posted. The visitor's message still reaches your team.
Office hours
Tick Enable Office Hours. Set Opening Time, Closing Time, Timezone and Working Days, and write an Offline Message. Outside those hours the window shows your message and the message box is disabled, so visitors cannot leave a message. Point them to your email or phone in the text. Empty fields mean 09:00, 17:00, Europe/Amsterdam and Monday to Friday. The window checks the hours when the page loads.
WhatsApp Integration
Tick Enable WhatsApp and enter the Phone Number ID and Business Account ID to route WhatsApp messages for that number through this chat. They appear as rooms labelled WhatsApp. What you type in such a room goes back to the sender on WhatsApp, and AI auto-reply covers WhatsApp too.
If you connected WhatsApp through Meta's signup under Social Media -> WhatsApp Business, Enydea subscribes to your account's messages itself and fills these fields on that relation's first chat, if it exists (Social media and WhatsApp). The screen also shows a webhook address and Meta instructions, which that route does not need.
Limits
- Your replies reach the visitor live over a WebSocket connection. If a visitor's network blocks WebSockets, they see your reply when they reload the page.
- The Chat widget switch in Settings -> Website Tracking is a separate, simpler bubble. It does not create rooms in Chats. Leave it off when you use this widget (Website tracking and consent).


