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.
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
In-widget help center 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 — knowledge base articles
You control which tabs appear, what they're labeled, and what content visitors see. Everything is configured from the Widget settings page in your dashboard.
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.
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.