Chat Widget
Install via HTML
Add Kerabie to any website with two script tags.
Get your widget key
- Log in to kerabie.com/app
- Go to Settings → Widget
- Copy your Widget Key (starts with
wk_)
Add the script
Paste both tags before the closing </body> on every page:
<script>
window.KERConfig = {
widgetKey: "wk_yourkey_here"
};
</script>
<script async src="https://cdn.kerabie.com/widget.js"></script>That's it: the chat bubble appears immediately.
Passing user identity
If your site has logged-in users, identify them so agents know who they're talking to:
<script>
window.KERConfig = {
widgetKey: "wk_yourkey_here",
user: {
name: "Jane Smith",
email: "jane@example.com",
userId: "user_123"
}
};
</script>Load only on specific pages
To show the widget on certain pages only, wrap the second script in a condition:
<script>
window.KERConfig = { widgetKey: "wk_yourkey_here" };
</script>
<script>
if (window.location.pathname.startsWith('/support')) {
var s = document.createElement('script');
s.src = 'https://cdn.kerabie.com/widget.js';
s.async = true;
document.body.appendChild(s);
}
</script>Content Security Policy
If your site uses CSP headers, add these directives:
script-src 'self' https://cdn.kerabie.com;
connect-src 'self' https://api.kerabie.com wss://ws.kerabie.com;
img-src 'self' https://assets.kerabie.com data:;
frame-src https://cdn.kerabie.com;