Website Chat Widget: Installation & Setup
Install the Bugalou live chat widget on your website to start conversations with visitors. Learn how to activate, embed, test, and manage allowed domains.
Overview
The Website Chat widget lets you add a live chat button to your website so visitors can start conversations with your team — or with your AI chatbot — directly from any page. Available on Starter, Pro, and Enterprise plans.
Getting to the Widget Settings
Navigate to Channels in the sidebar, then click "Manage" (or "Connect") on the Website Chat card. This opens the Website Chat configuration page with six tabs: Installation, Pre-chat Form, Appearance, Autoresponder, FAQ, and Behavior.
Activating the Widget
On the Installation tab, you'll find the Widget Status card with a toggle switch. Turn it on to activate the widget on your website. The status indicator will change to a green "Active" badge.
Embedding the Code
Below the status toggle you'll find the Installation Code card. It contains a JavaScript snippet like this:
<script src="https://yourdomain.com/widget/loader.js" data-widget-key="your-unique-key"></script>
Click the "Copy" button to copy the snippet to your clipboard. Paste it just before the closing </body> tag on every page where you want the chat widget to appear.
Testing Your Installation
Use the Test Installation card to verify the widget is working:
- Enter your website domain (e.g.
example.com) in the text field - Click "Test Installation"
- A success or error message will appear telling you whether the widget was detected
Allowed Domains
In the Allowed Domains card you can restrict which domains are allowed to load the widget:
- Enter a domain (e.g.
*.example.comfor all subdomains) and click the + button to add it - Each domain appears in a list with a remove button
- If no domains are specified, the widget works on any domain
Click "Save Changes" to persist your settings.
Tip
If you use a CMS like WordPress, you can add the widget code via a plugin like "Insert Headers and Footers" or paste it in your theme's footer template.