Install the chat widget

Where to find your embed code

Open your chatbot and go to the Installation tab. It shows a single script tag with your bot id in a data-bot-id attribute. That one tag is the whole installation; there is nothing else to configure in your site's code.

Add it to your site

• 1. Copy the script tag from the Installation tab.
• 2. Paste it into your site's HTML, just before the closing body tag, on every page where the widget should appear.
• 3. Reload a page on your site. The chat bubble appears in the corner.

The widget works on any site where you can add a script tag: hand-coded pages, CMS themes, and site builders with a custom code option. It renders inside a Shadow DOM, so your site's CSS and the widget's styles do not interfere with each other. For placement options beyond the floating bubble, see embed options.

What visitors see

Visitors get a chat bubble that opens into a conversation. Answers stream in with a typing indicator, and up to 4 source pills under an answer show where it came from. Colours, position, avatar, and the rest are set on the Appearance page; see widget appearance and behaviour.

Changes take about a minute to go live

The widget's configuration is cached on a CDN. When you change appearance or behaviour settings, live sites pick up the change within about 60 seconds. If you are watching your site for a change, wait a minute and refresh before assuming something is wrong. More on this in widget changes not showing.

The curl example on the same tab

The Installation tab also shows a simple curl example that calls the widget's chat endpoint over REST. It is handy for a quick test from a terminal, or as a starting point if you want to send messages from your own code instead of the widget. For the full authenticated API, see the public REST API.