Install Guide · 3 minutes
Install Chatonbo on any site via Google Tag Manager
If you already use GTM (most marketing teams do), you can deploy the Chatonbo chatbot to every page of your website without editing a single line of site code. This guide walks through the seven clicks.
Why install via GTM?
- No code editing. You won't touch theme.liquid, footer.php, or any HTML file.
- One control panel for every script. Analytics, ad pixels, and the chatbot all live in the same place — easier to audit and manage.
- Versioning and rollback. Every Submit creates a version. If anything breaks, you roll back in two clicks.
- Per-page targeting. Show the chatbot only on /pricing, only on /demo, or only on mobile — using GTM's built-in trigger conditions.
Grab your Chatonbo install snippet
Log into chatonbo.com, open your bot, and click the Install tab. Copy the HTML snippet — it's two short <script> tags that include your bot ID. You'll paste this into a GTM tag in step 4.
- ✓Find it under your bot → Install tab
- ✓It's two <script> tags
- ✓Contains your bot ID — keep it private
Open Google Tag Manager
Go to tagmanager.google.com and pick the workspace for your website. If you don't have GTM set up on your site yet, follow Google's "Install Tag Manager" instructions first — that's a one-time setup that adds the GTM container to your site's <head>. Once GTM is live, every future change can be made inside GTM without ever touching your site code again.
- ✓Container = your website's GTM workspace
- ✓GTM itself only needs to be installed once
- ✓After that, any new tag (analytics, chatbot, ads) goes through GTM
Create a new tag
In the left sidebar click Tags, then click the New button. In the panel that opens, click "Tag Configuration" and choose Custom HTML from the list. Give the tag a clear name like "Chatonbo Chatbot Widget" so you can find it later.
- ✓Tags → New → Custom HTML
- ✓Name it "Chatonbo Chatbot Widget"
- ✓Custom HTML supports any external script
Paste your Chatonbo snippet
In the HTML field, paste the snippet you copied in step 1. Don't modify it — Chatonbo's widget loads asynchronously, so it won't slow your page. Leave the "Support document.write" checkbox unchecked. The tag is now configured but doesn't run yet — we still need to tell GTM when to fire it.
- ✓Paste both <script> tags as-is
- ✓No modifications needed
- ✓Don't enable "Support document.write"
Add the "All Pages" trigger
Below the Tag Configuration block, click the Triggering section and pick "All Pages — Page View" from the list. This makes the chatbot load on every page of your site. If you only want it on specific pages (e.g. just /pricing or just product pages), create a custom Page View trigger with URL conditions instead.
- ✓Trigger: All Pages — Page View (recommended)
- ✓Or create a custom trigger for specific URLs
- ✓You can change this anytime later
Save and Submit
Click Save in the top right. You'll be back at the Tags list — your new tag is created but still in "Workspace Changes," not yet live on your site. Click the blue Submit button (top right), give the version a name like "Add Chatonbo chatbot," and click Publish. The chatbot is now live on every page in seconds.
- ✓Save → Submit → Publish
- ✓Always Submit, otherwise the change isn't live
- ✓Each Submit creates a version you can roll back to
Verify it works
Open your website in a fresh browser tab — the Chatonbo chat bubble should appear bottom-right within a second. If it doesn't, go back to your bot in chatonbo.com → click Install → click "Verify install" — we'll probe your site and tell you exactly what's wrong (most common cause: an aggressive JS optimization plugin deferring third-party scripts; we detect that automatically).
- ✓Hard-refresh in a new tab
- ✓Click "Verify install" in your dashboard
- ✓We detect deferral plugins and give exact fixes
If the chat bubble doesn't appear
- Did you Submit/Publish? Saving a tag is not enough — you must also click Submit + Publish for changes to go live.
- Hard-refresh. Cmd/Ctrl+Shift+R bypasses your browser's cached HTML.
- Aggressive JS optimization plugin? WordPress sites with LiteSpeed Cache, WP Rocket, or Autoptimize can defer GTM-injected scripts. Open your bot's Install page in chatonbo.com and click Verify install — we'll detect this and give exact fix instructions.
- Browser ad-block extensions. Some block the entire GTM container on your local browser. Try a private window or a different browser.
- GTM container not on your site at all. View your site's page source and search for
GTM-. If you don't see it, GTM itself isn't installed yet — follow Google's setup guide first.
See it work on your own website
Paste your URL and chat with an AI agent trained on your content — right now, in 60 seconds.
Try It on Your Website