Website chat widget

The website chat widget is a floating WhatsApp button for your site. A visitor taps it, a small panel opens with your brand at the top and an opening message already written for them, and Chat On Whatsapp drops them into a real WhatsApp conversation with your business - which arrives in your Inbox like every other chat.

Setting it up is five short tabs and one copy-paste. The rest of this guide walks each of them, starting from wherever you are in the app right now.

The widget lives in the Admin Dashboard, not inside a workspace. That’s deliberate: the widget belongs to your brand, so one setup covers every workspace under it. Three clicks from anywhere in the app.

The page lists the chat surfaces provisioned for your brand, one card per channel. This guide is about the WhatsApp card. If your brand also has the Q&A Widget, it appears as a second card: it answers visitors from your Knowledge Hub and hands them to WhatsApp when it can’t, and it has its own setup and its own embed code.

• Edit Widget - the five-tab setup dialog.
• Copy Embed Code - the snippet to paste into your website. You only ever do this once.

Edit Widget opens a five-tab dialog over the page. You can move with Next / Previous or click any tab directly - the numbering is a suggested order, not a locked wizard. On a wide window a live preview of the visitor’s view sits to the right of the form and updates as you type; it flips between Collapsed and Open, and (once you have path-specific messages) a dropdown lets you proofread each one.

Back on the widget page, press Copy Embed Code on the WhatsApp card. The dialog shows the snippet plus the three-line install instruction, with a Copy button above the code and Copy Code at the bottom of the dialog.

Then, on your website:

The snippet’s position line follows the corner you picked on the Launcher tab, so change it in the app and copy the embed code again rather than editing the pasted code by hand.

• The welcome message is the visitor’s message, not yours. It pre-fills the visitor’s WhatsApp compose box, so write it in their voice (“Hi! I would like to find out more about…”), not yours. It is what lands in your Inbox as their opening line.
• Use a number that’s actually connected to Exabloom. The field accepts any number and doesn’t check it against your connected WhatsApp account. Type the wrong one and chats go to that phone - never to your Inbox.
• Nothing saves until you press Save Widget. You can click freely between the five tabs, but closing the dialog with Cancel discards everything you changed. Save Widget only appears on the last tab, Review.
• The Review tab doesn’t show everything. It lists type, phone, base message, the launcher (style, position, invite) and the default visibility. Path-specific messages, the Source tracking switch and your include/exclude paths aren’t summarised there, so check those on their own tabs before saving.
• Paths are paths, not full URLs. Enter /pricing, not https://yoursite.com/pricing. Use * to cover a whole section. For path-specific messages, an exact path beats a wildcard when both match.
• Pick one direction for visibility. Use Include Paths with Hide on all pages, and Exclude Paths with Show on all pages. Don’t put the same page in both lists, and load a page you’ve just excluded to check it’s really gone.
• The invite fires once, and only when it can. It needs at least one condition switched on; with Only these paths and no paths added it never fires. Once a visitor opens the chat or dismisses the bubble, that browser isn’t invited again. Time counts only while the tab is visible, and carries across pages in the same visit.
• Install once, edit anytime. The snippet only carries your configId and corner - it fetches the live config each time the page loads. Change messages, numbers, launcher or visibility later and your site picks it up with no re-paste.
• Source tracking is on for new widgets. With it on, each chat opens with a Ref: #… line at the end of the message, which is how the contact gets its source. See Track where your WhatsApp chats come from. A widget saved before the switch existed keeps it off until you turn it on.
• No widget on the page? It hasn’t been provisioned. There’s no “create widget” button on the WhatsApp card - it’s set up for your brand by us. If you see “No chat widgets found”, message us and we’ll add one.
• The live preview needs a wide window. It sits beside the form and is hidden on narrow screens - set the widget up on a laptop or desktop, not a phone.