Skip to main content
Putting your bot live takes one line of code. You copy a script tag from the Deploy page and paste it into your site. The chat bubble then appears on every page automatically – no plugin, no developer needed.

​
Add the script tag

Open the Deploy page

In your bot’s dashboard, open the Deploy page. You’ll see a ready-to-use script tag with your bot’s key already filled in.

Copy your script

Click Copy to put the snippet on your clipboard. It looks like this:
Your real apiKey is already in the snippet on the Deploy page – the one above just shows the shape. It loads your bot.

Paste it before </head>

Paste the script into your site’s HTML, just before the closing </head> tag. The async attribute keeps your page fast – the bot loads in the background.

Publish your site

Save and publish. The bubble now shows on every page. The first time the widget loads on your live site, your bot is marked as deployed.
Tested your bot but haven’t embedded it yet? Chatref sends you a friendly reminder email with the snippet, so the code is always one click away when you’re ready to go live.

​
Where to paste it

You only paste the script once. Where it goes depends on your site builder, but the rule is the same everywhere – put it in the page <head> (or a “header scripts” / “custom code” box) so it loads on every page.
If your builder only offers a single “custom code” box, paste the script there. Site-wide head code is what makes the bot appear on every page at once.

​
Rotating your key

If your key is ever shared by mistake, you can rotate it from the Deploy page. Rotating creates a new key and disables the old one right away.
After you rotate, your old snippet stops working. Update the script tag everywhere you pasted it – every site, theme, or page – with the new key, or the bot will stop loading there.

​
Next steps

Run several bots from one script

Use one workspace script to show different agents on different pages.

Lock the widget to your sites

Allow only your own domains to load the widget.