Installing a chatbot

To put a chatbot on your website, you paste one line of code into your pages and tell us which websites may show it. Everything is on the chatbot's Install tab.

The tab has five rows: Add it to your website, Websites, AI model and key, Daily limit and Signed-in customers. Save, at the bottom right, saves the websites, the model and key, and the daily limit. The signed-in customers row saves straight away.

Add it to your website#

1. 1

   Open the chatbot and select the Install tab.

2. 2

   Under Add it to your website, click Copy to copy the code.

3. 3

   Paste it just before the closing </body> tag on every page where the chat should appear. In a single-page app, put it in the main HTML page once.

4. 4

   Under Websites, list your websites in Website addresses, one per line. Click Save at the bottom.

5. 5

   Make sure the chatbot is live, then open your website and check that the chat button appears.

The code looks like this. Use your own copy, because the data-bot value is different for each chatbot.

<script src="https://…/widget.js" data-bot="cb_…" async></script>

Most website builders have a "Custom code", "Embed code" or "Footer scripts" setting where you can paste it once for the whole site.

List your websites#

In Website addresses, under Websites, enter one website per line, for example:

https://www.example.com
https://app.example.com

• Only the start of the address counts: https://www.example.com/help is saved as https://www.example.com.
• If you leave out https://, it's added for you.
• www.example.com and example.com are different websites. List both if visitors use both.
• A different port counts as a different website, for example http://localhost:3000 for testing on your own computer.
• You can list up to 20 websites.

AI model, key and limits#

On top of your daily limit, each visitor can send at most 20 questions every 10 minutes.

When a limit is reached, visitors see a short message instead of an answer:

Signed-in customers#

This row is for a chat inside your portal, where your server says who is asking. It has the Only signed-in customers may use this chat switch, Create signing secret (or Replace signing secret), and How to set it up, which opens a short guide in a pop-up. Changes here are saved straight away, without the Save button. See Signed-in visitors.

Delete chatbot…, at the bottom left of this tab, removes the chatbot for good. See Creating a chatbot.

Removing the chat from a page#

To stop the chat on a page, remove the code. To hide it for everyone at once, click Switch off at the top of the chatbot's page.

In a single-page app, you can remove it while the page is open, for example when someone signs out:

window.CerberiusChat.destroy();

If the chat doesn't show#

Open your browser's developer console (usually F12, then Console) on the page. The chat leaves a short note there when it can't start.

If the chat button shows but answers fail, check the top of the chatbot's page for a list of what's missing, such as a help source or an AI key. On the Conversations tab, open the chat: a failed answer shows Not answered and the reason.