Add the chat widget to your site
One script tag puts the live chat on every page of your site.
Every brand in Flagbell has its own widget key (fbw_…). Put this tag on your pages, just before </body>:
<script src="https://app.flagbell.com/widget/v1/widget.js" data-key="fbw_…" async></script>
A chat button appears in the bottom right corner. A dot on it shows whether someone of your team is online.
Options on the tag
| Attribute | What it does |
|---|---|
data-key | Your brand's widget key (required). |
data-color | The accent colour, as a hex colour. Default: #1F3BFF. |
data-lang | en or nl. Without it the widget follows the page's <html lang>, then your brand's language. |
data-user-token | Who is signed in on your site. See Chat with signed-in visitors. |
data-mailbox | partner on pages for partners. See Chat on partner pages. |
Which sites can use it
The widget only works on the sites (origins) listed for your brand, and always on your brand's help centre. Chats from any other site are refused.
Content Security Policy
If your site sends a CSP, allow Flagbell for the script and the live connection:
script-src 'self' https://app.flagbell.com;
connect-src 'self' https://app.flagbell.com wss://app.flagbell.com;
The widget sets no cookies. It draws itself in its own Shadow DOM, so your styles don't reach it and its styles don't reach your page.
Updated 23 October 2026