Chat Widget
Chat Widget
The Kerabie chat widget runs on any website and connects visitors to your team in real time.
The widget is a lightweight JavaScript snippet (~8 KB gzipped). It renders a chat bubble on your site, opens a conversation panel, and connects via WebSocket for real-time messaging.
Installation methods
| Method | Best for |
|---|---|
| HTML script tag | Any static site, custom builds |
| WordPress plugin | WordPress sites |
| Webflow / Squarespace / Wix | No-code builders |
| Shopify | E-commerce |
| React Native SDK | Mobile apps |
Identifying visitors
Pass user data so agents see who they're talking to:
<script>
window.KERConfig = {
widgetKey: "wk_yourkey_here",
user: {
name: "Jane Smith",
email: "jane@example.com",
userId: "user_123", // your internal ID
plan: "pro", // any custom attribute
}
};
</script>
<script async src="https://cdn.kerabie.com/widget.js"></script>JavaScript API
Control the widget programmatically:
// Open / close
window.Kerabie.open();
window.Kerabie.close();
window.Kerabie.toggle();
// Unread count
window.Kerabie.on('unreadCount', (count) => {
document.title = count > 0 ? `(${count}) My App` : 'My App';
});
// Pre-fill a message
window.Kerabie.openWithMessage('I need help with my order');Available plans
| Feature | Free | Starter | Pro | Business |
|---|---|---|---|---|
| Widget on unlimited pages | ✓ | ✓ | ✓ | ✓ |
| Remove "Powered by Kerabie" | No | No | ✓ | ✓ |
| Custom pages in widget | No | No | ✓ | ✓ |
| Domain whitelist | ✓ | ✓ | ✓ | ✓ |