Connections
The chat widget on your site
Install the chat widget with one line of code, tailor it to your brand, and add identity verification if you want to know who’s on the other side.
Reading time · 6 min read
The chat widget is a lightweight live-chat button that appears in the corner of your website. You can run more than one widget — for example one per website or brand — depending on your plan.
Set up a new widget
- 1
Go to Chat widgets
Click "New widget" and give it a name (e.g. "Main site" or "Support portal").
- 2
Customize the look
Open the widget and go to the Appearance tab: pick a theme (bubble, bar or card), colour, font, side (left/right), corner style and launcher icon — with a live preview.
- 3
Write a greeting and quick replies
Add a greeting message visitors see first, plus a few quick replies they can click instead of typing.
- 4
Copy the embed code
Go to the Install tab and copy the <script> snippet. Place it right before the closing </body> tag on your website — the chat button appears instantly.
The embed code and appearance settings are also reachable from Settings → Chat widget, which points directly to the same widget tool.
Business hours and after-hours messages
Turn on business hours in the appearance settings and add a message that shows when your team is away — e.g. an expected reply time. That way visitors know exactly what to expect, even if no one answers instantly.
Verifying visitors before chat starts
Under "Identity before chat starts" you can choose between three levels:
- None — visitors chat anonymously, the default.
- Name + email — the visitor is asked for a name and email before chatting.
- Kenni electronic ID — the visitor signs in with Icelandic electronic ID, giving you a verified national ID number, name and phone number before the conversation starts.
Kenni needs to be connected first
Kenni verification only works once it’s connected under Settings → Integrations → Kenni electronic ID. If it isn’t connected, you’ll see a warning with a direct link. Kenni is priced separately per kenni.is and is not included in your Spjallbox plan.
AI inside the chat widget
In the appearance settings you can turn on "Let the AI reply automatically" so it answers visitors directly from the knowledge base without an agent needing to be present — ideal outside business hours. Turn it off any time you want agents to take over completely.
The form channel as an alternative
If you’d rather have a simple form than live chat (e.g. on a contact page), a ready-made HTML snippet for the form channel is available under Settings → Chat widget. Submissions automatically become cases in the inbox, just like chat messages.
Security: verifying user identity
If you sign your own logged-in users into the chat widget using your own identity system (e.g. a user ID), use the HMAC secret under Settings → Chat widget to sign the identity on your server. This prevents anyone from impersonating another user.
Can I run more than one chat widget?+
Yes. The number of widgets (brands) depends on your plan — see "Subscription and billing".
Do visitors see a "Powered by Spjallbox" badge?+
By default, yes on lower-tier plans. You can remove it on the Growth plan and above.
Can I change colours and fonts after the widget is live?+
Yes, every appearance change appears instantly for visitors without touching the embed code.