Chat Messages

Chat messages are proactive engagement elements that send a personalized message to a website visitor through the chat widget. They arrive as an incoming chat message, creating a natural opening for a conversation based on what the visitor is doing.

How Chat Messages Work

Chat messages are delivered through your existing chat widget, appearing as automated messages that visitors receive while browsing your site. Unlike banners, which sit on top of the page content, messages integrate into the chat itself, so they read as part of the conversation.

The message is saved in the conversation

Each time a chat message is sent, its text is also saved into the visitor's conversation. That gives you a record of what was said to whom, and the agent who picks up a reply sees your message above it.

  • Which conversation: the visitor's newest website-chat conversation, however old it is — so the message can land at the end of a conversation from months ago. A visitor with no conversation yet gets a new one.
  • Who it is from: it has no sender. The visitor sees it as coming from Yaplet when they open the chat, and the inbox shows the same name.
  • It stays quiet until the visitor writes back. The conversation shows up under All in the inbox, but not under Unassigned, and no agent is notified. That holds even if the visitor's newest conversation is already waiting for an answer: it stays where it was in the inbox and your chat message becomes its newest line, but agents are still not alerted, because only what the visitor writes sends an alert.
  • The inbox AI tools skip it. Draft a reply and Summarize chat ignore messages that have no sender, so they don't see this one — see AI Tools.

Write {{name}} (exactly like that, no spaces) to greet the visitor by first name — it becomes the first word of their name, in the pop-up and in the saved message alike. When the name is unknown it is simply left out, so Hi {{name}}, welcome back! becomes Hi , welcome back!.

Visitors who are fully blocked (banned from chat) don't receive chat messages — the message would invite a reply they can't send — so nothing is saved for them either. Banners, surveys and tours are unaffected.

Triggering Chat Messages

Chat messages can be triggered by events and conditions such as page visits, time-based rules or custom events sent from your application. For details on configuring them, see the trigger documentation.

Trigger Configuration

Learn about all available trigger options and how to configure them for your messages.

Message Settings

Open a chat message from the list to edit it. The page shows a preview of the pop-up at the top and a Settings section under it ("What the message says, where it shows, and what a click does"). Reports and Trigger buttons sit in the page header next to the save controls: Unsaved changes appears with Discard and Save changes as soon as you edit something, and leaving with unsaved edits asks first.

Basic Configuration

Name
string required
A descriptive title for your message, used in the dashboard.
Widget
string required
Which chat widget this message belongs to — and therefore which website it appears on. A brand has at most one chat widget, so in practice you are choosing the brand.
Published
boolean
Whether the message is active and can be sent to visitors. Visitors only get the message while this is on.
Content
string required
The text of the chat message — the text visitors see in the pop-up.
When clicked
select
What happens when the visitor clicks the message bubble (see Message Actions below).

The Chat Messages List

Click Add Chat Message to create one: choose New Item to start from scratch, or pick one of the ready-made templates.

The list opens as a table with one row per chat message, and two buttons at the top right switch between List view and Card view (Yaplet remembers your choice in this browser). A strip of numbers above it shows how many messages are Live and how many are Drafts, plus Shown · 30 days, Clicked · 30 days and the Engagement rate. The All, Live and Draft buttons narrow the list by state, and you can search, filter by widget and sort.

Each row shows the priority arrows, a color tile with the message name and the start of its text, a switch with a Live or Draft badge (flip it to put the message live or turn it off right from the list), the widget, Shown, Clicked and Rate for the last 30 days, the creation date, Reports and Edit buttons and a ⋯ menu with Edit, Reports, Duplicate and Delete. In Card view, each card shows the message preview, name, widget, a Live/Draft badge, creation date and a one-line performance summary for the last 30 days (a message nobody saw in that period says so instead of showing zeros), with a Reports shortcut next to Edit in the card footer.

Message Priority

Priority is not set inside the editor. On the Chat Messages list, use the up and down arrows at the start of each row — or, in Card view, the two arrow buttons beside the Priority number in the card footer. Hover them for Increase priority and Decrease priority. When several chat messages qualify for the same visitor at the same moment, only the highest-priority one is sent — messages compete with other messages, not with banners, surveys or tours.

Message Actions

The When clicked option cards set what happens when a visitor clicks your message. A short hint under the cards explains the one you picked.

Start conversation

Opens the chat and starts a new conversation, ready for the visitor to reply. You can optionally pick a workflow to run in it (Optionally select a workflow to start) — the picker lists the chosen widget's active custom workflows, and None leaves the conversation to start empty.

Open widget home

Opens the widget on its home screen, with whatever you put there on Brand → (your brand) → Chat widget → Home screen.

Preview & Testing

Use the built-in preview to see how your chat message will appear in the widget. The preview shows the message bubble styled with your widget's colors and branding. It shows up to 4 lines of text and cuts off the rest, and it prints {{name}} as written rather than filling in a name.

Because a chat message has no sender of its own, the pop-up on your site looks the same as the preview: Yaplet's face, a line reading Yaplet · AI assistant (the words after the dot appear in the visitor's own language) and then your text, up to 4 lines. The visitor can close it with its close button, and it slides away on its own after about 10 seconds — it stays while the pointer is over it, and the unread count stays on the chat button. It is not shown while the chat window is already open, because the message is already in the conversation.

Testing engagement campaigns

Learn how to safely test your campaigns before letting them reach live visitors.

© 2026 Yaplet. All rights reserved.