The Brand2Chat Widget Setup lets you configure the chat widget that appears on your website for your customers. You can customise the widget name, position, greeting message, offline message, and language then copy a ready-to-use embed script to install it on any website within minutes.
How to Access Widget Setup
1. Log in to your Brand2Chat account.
2. Click on Widget Setup in the left-side navigation menu.
3. The Widget Setup form will load with all configurable options for your chat widget.
What You Can Configure
Widget Name
The internal name for your widget. This is also displayed to visitors as the title of the chat window (for example, “Support Chat”).
Position
Choose where the chat bubble appears on your website pages Bottom Left or Bottom Right.
Greeting Message
The first message visitors see when they open the chat widget. Keep it friendly and helpful (for example, “Hi, how can we help?”).
Offline Message
The message displayed to visitors when none of your agents are available. This assures visitors their message has been received (for example, “We are offline now. Leave your message and we will reply soon.”).
Language
Set the display language for your chat widget interface.
Widget Key
A unique identifier automatically generated for your widget. This is embedded in your script and connects the widget to your Brand2Chat workspace.
How to Set Up Your Widget
1. Go to Widget Setup from the left sidebar.
2. Enter a Widget Name for your chat window.
3. Choose the Position Bottom Left or Bottom Right based on your website layout.
4. Write a Greeting Message that visitors will see when they open the chat.
5. Write an Offline Message for when your team is unavailable.
6. Select the Language for the widget.
7. Click Save Widget to save your configuration.
8. Once saved, the Website Embed Script section will display your unique script tag.
9. Click Copy Script to copy the embed code.
10. Paste the script just before the </body> closing tag on every page of your website where you want the widget to appear.
11. Use the Enabled toggle at the top right to activate or deactivate the widget at any time without removing the script from your site.
ℹ️ Note: Your Widget Key is unique to your workspace. Do not share it publicly or use it across multiple Brand2Chat accounts.
Your Website Embed Script
After saving your widget, Brand2Chat generates a script like this:
<script src="https://app.brand2chat.ai/embed/chat-widget.js"
data-widget-key="your-unique-widget-key"
data-api-base="https://app.brand2chat.ai/api/widget/v1"
data-ws-base="https://app.brand2chat.ai/api"
async>
</script>
Paste this into your website’s HTML before the </body> tag. The widget will appear automatically once the page loads.
Enabling and Disabling the Widget
You can turn the widget on or off at any time using the Enabled toggle at the top right of the Widget Setup page. When disabled, the chat bubble will not appear on your website even though the script is still installed useful during maintenance or off-hours configuration.
Troubleshooting
The chat widget is not appearing on my website
- Confirm the embed script is placed correctly before the
</body>tag on your webpage. - Check that the Enabled toggle on the Widget Setup page is turned ON.
- Clear your browser cache and reload the page, as cached versions of the page may not show the updated script.
The widget is showing the wrong language
- Go back to Widget Setup, update the Language field, click Save Widget, and reload your website.
