Widget Overview
The Yaplet widget is a customizable chat interface that you embed on your website — giving visitors instant access to live chat, AI assistance, a knowledge base, news, and more, all from a single floating button.
What Is the Widget?
The widget is a lightweight overlay that lives in the corner of your website. When a visitor clicks the launcher button, it expands into a full panel with multiple tabs and features — no page navigation required.
From the visitor's perspective, it's a single, cohesive experience. Behind the scenes, it combines several powerful systems: real-time messaging, an AI chatbot, self-service help articles, product announcements, feedback collection, and more.
Every chat widget belongs to a brand. The brand owns the public web address, the knowledge base shown in the Help tab, the AI that answers, and the knowledge behind it — the widget itself only controls how the panel looks and behaves. A brand has at most one chat widget, and you configure it at Brand → Chat widget in your dashboard.
Key Capabilities
Home Screen
The first thing visitors see — a branded greeting, team avatars, background decorations, and interactive cards that guide them to the right action.
Live Chat
Real-time conversations between visitors and your team. Supports text, images, file uploads, email collection, satisfaction ratings, and agent handoff.
AI Chatbot
AI-powered conversations with streaming responses, conversation starters, product recommendations, and seamless handoff to custom workflows or live agents.
Knowledge Base
An in-widget knowledge base where visitors can browse categories, search articles, and find answers without leaving the chat.
How It All Fits Together
The widget is organized around a tabbed menu at the bottom of the panel. Depending on your configuration, visitors can switch between:
- Home — the landing screen with cards and quick actions
- Messages — live chat and AI chatbot conversations
- News — product announcements and updates
- Roadmap — feature voting board
- Help — the knowledge base published at your brand's public web address
You control which tabs appear and what they are labeled at Brand → Chat widget, the chat widget designer in your dashboard. Which knowledge base the Help tab serves is chosen on Brand → Knowledge, not in the designer.
Customization at Every Level
The widget is designed to match your brand and workflow:
| What you can customize | Where to learn more |
|---|---|
| Colors, backgrounds, and theme | Color System, Background Styles |
| Logo, launcher icon, and badge | Branding, Menu & Dark Mode |
| Greeting text and team display | Greeting, Welcome & Team |
| Home screen content blocks | Home Screen Cards |
| Dark mode | Branding, Menu & Dark Mode |
| Menu tabs and labels | Branding, Menu & Dark Mode |
For a complete overview of all visual customization options, see the Appearance & Theming section.
If You Delete the Chat Widget
Deleting the widget is not the same as deleting the brand. The brand survives, and with it the public web address, the knowledge base, the documentation, the products and the AI — your pages simply lose the chat bubble. Brand → Chat widget then offers an Add a chat widget button to put one back.
Banned Visitors
When a visitor has been banned from the Inbox sidebar or the Security Visitors page, the widget reflects that on their next visit:
- The chat composer is disabled and the visitor sees an error when trying to start a new conversation
- Existing conversation history stays readable, but no new messages can be sent
- If you see this state in your own widget while testing, the visitor identity you are using is banned — unban from the inbox or security pages and reload
The ban is per organisation and follows the visitor record itself, not the browser. It also extends beyond chat: inbound calls to your Voice agent numbers from any phone tied to that visitor are rejected before pickup.