Embedding the Chat Widget – ZENIA Assistant

Embed

Add the ZENIA AI chat to an external website with a single script tag. No build tools and no extra dependencies are required.

Quick start

Basic example

Add this before the closing </body> tag:

HTML

<script
  src="https://buildbot.ro/js/widget.js"
  data-domain="example.com"
></script>

All options

Example with optional settings

HTML — all options

<script
  src="https://buildbot.ro/js/widget.js"
  data-domain="example.com"
  data-theme="buildbot-theme-dark"
  data-position="bottom-left"
  data-welcome-message="Welcome! How can I help you today?"
></script>

Attributes

Public script options

Option	Required	Default	Description
Domain detection	No	Current website hostname	The external widget script detects the website hostname automatically from the page where it is installed. You do not need to pass a domain attribute. Make sure the domain has been added and indexed in ZENIA.
`data-theme`	No	`buildbot-theme-light`	Optional widget theme class. Supported values are `buildbot-theme-light`, `buildbot-theme-dark`, `buildbot-theme-zenia-light`, `buildbot-theme-zenia-dark`, `buildbot-theme-monochrome`, `buildbot-theme-girly`, `buildbot-theme-blush`, and `buildbot-theme-console`. Invalid values fall back to the default light theme.
`data-position`	No	`bottom-right`	Optional widget placement. Supported values are `bottom-right`, `bottom-left`, `top-right`, and `top-left`. Invalid values fall back to `bottom-right`.
Welcome message	No	Saved domain setting	The welcome message is managed from the domain settings where this option is available. It is not configured through the public embed script.

How it works

1. The script detects the current website hostname and prepares the chat for the matching domain in ZENIA.
2. It creates a floating chat button on your website.
3. When a visitor clicks the button, the chat panel opens on the page.
4. Optional settings such as data-theme and data-position adjust the launcher appearance and placement.

Embed mode

Embedded chat behavior

The public widget is designed to load the ZENIA chat experience inside your website without requiring build tools or a custom integration. The embed script handles the floating button, chat panel, placement, and basic appearance options for you.

For most websites, you only need to paste the basic script before the closing </body> tag. Add data-theme or data-position only if you want to override the default appearance or placement.

Themes

Theme values

Use one of the supported values for data-theme: buildbot-theme-light, buildbot-theme-dark, buildbot-theme-zenia-light, buildbot-theme-zenia-dark, buildbot-theme-monochrome, buildbot-theme-girly, buildbot-theme-blush, or buildbot-theme-console.

Available themes

buildbot-theme-light
buildbot-theme-dark
buildbot-theme-zenia-light
buildbot-theme-zenia-dark
buildbot-theme-monochrome
buildbot-theme-girly
buildbot-theme-blush
buildbot-theme-console

Dashboard

Using the dashboard snippet

The easiest way is to go to your domain's Settings > Embed Code tab and copy the generated snippet if this option is available. Paste it into your site before the closing </body> tag.

WordPress

WordPress / site builders

Most site builders have a Custom HTML or Custom Code block. Paste the embed snippet there. In WordPress, you can usually use a Custom HTML widget, a custom-code plugin, or your theme's footer area before </body>, depending on how your site is managed.

Help