Add the chat to your website
Publish your agent, paste one line of code into your site, and check it's working.
Customers talk to your agent through a chat button on your website. Publishing turns the chat on for your website's address, and one line of code puts the button on your pages.
Before you publish
Select Preview on the agent's page and ask a few questions your customers ask. If Publish can't be selected, add instructions and choose at least one folder for the agent.
Publish your agent
Open the agent
In Agents, open the agent you want customers to talk to.
Select Publish
Publish is at the top of the agent's page.
Enter your website address
Enter the full address customers visit, such as https://www.yourshop.co.uk, then select Publish.
Add the code to your site
Once it's published, you'll see the code to add. Select Copy code, or Email the code to whoever looks after your website. The email links to this page.
Paste the code once, somewhere that's on every page, usually the footer. The chat appears as soon as the code is live on your site. Find your site builder below. Each links to its own guide, with pictures.
Shopify
In Online Store, open Themes, then Edit code from your theme's menu. Open layout/theme.liquid, paste the code just before </body>, and save. Shopify shows how to open and use the editor in Editing theme code.
WordPress
Paste the code into your theme's footer. To add it without editing your theme, a plugin such as WPCode can put it in the footer for you.
Wix
Paste the code in Settings, under Custom code, on all pages, at the end of the body. Wix shows how in Embedding custom code on your site.
Webflow
Paste the code in Site settings, under Custom code, in Footer code, then publish your site. Webflow shows how in Custom code in head and body tags. Custom code needs a paid Webflow plan.
Squarespace
Paste the code into Code Injection, in Footer. Squarespace shows how in Code injection. Code injection isn't on every Squarespace plan.
Citrus-Lime Cloud MT
Ask Citrus-Lime support to add it for you.
Something else
Paste the code into your site's footer, or its custom-code box, so it's on every page.
If your site has a security policy
Some sites have a Content Security Policy: a list of the addresses they're allowed to load from. If yours does, the chat button won't appear until https://turboagent.app is on that list. Ask whoever looks after your website to add it to these three:
| Directive | What it lets the chat do |
|---|---|
script-src | Load the chat code |
frame-src | Show the chat |
connect-src | Start chats and count visits to your site |
For example, a policy that only allows your own site becomes:
script-src 'self' https://turboagent.app; frame-src 'self' https://turboagent.app; connect-src 'self' https://turboagent.appCheck it's working
Open your website in a new tab. The chat button appears in the bottom corner. Ask it a question to be sure.
Back in Turbo Agent, the button at the top of the agent's page shows Finish install until the code is found on your site, then Live.
If the chat hasn't loaded on your site for a day, the button shows Check install instead. Select it to see when the chat last loaded, with the code to add again if it's no longer on your site, or Unpublish if you no longer want it there. The button shows Live again as soon as the chat loads.
Administrators also get a notification, but only if your site had visits every day of the week before. On a quieter site, a day without the chat is normal.
Stop counting website visits
The chat code counts visits to your pages for Insights. To stop, ask whoever looks after your website to add data-reporting="off" to the code:
<script src="…/widget.js" data-turbo-agent data-deployment="…" data-reporting="off" async></script>The chat keeps working, but you won't get a notification if it stops loading.
Change the addresses it runs on
The chat only runs on the addresses you publish to, so the code does nothing if it's copied onto another site. Each address has to match exactly: if your site opens both with and without www, enter both, separated by a comma.
To change them, select Live, Check install or Finish install at the top of the agent's page. Open More options and select Change address. Enter every address the chat should run on, separated by commas, then select Save.
If you remove every address the chat has loaded on, the button shows Finish install until the chat loads on one of its current addresses.
Take the chat off your site
Select Live, Check install or Finish install at the top of the agent's page. Open More options, select Unpublish, then confirm. Under Check install, Unpublish is next to Copy code instead. The chat button disappears from your website until you publish again. Chats already open stay in your inbox.
You don't need to remove the code. It stays inactive until you publish again.