Get it live
Install Adoomi with Google Tag Manager
The chat bubble live on every page of your site, published from the Google Tag Manager container you already run.
Before you start
- Your bot's Status is active How to check
- Your website's address is in Allowed domains (comma-separated) How to check
- Your website already carries its Google Tag Manager container code
- Your Google account can edit and publish that container
About 10 minutes. You’ll do four things:
- copy the line
- make a Custom HTML tag
- publish the container
- check it's live
Adoomi has no tag template in Google Tag Manager. There is nothing to look for in the template gallery. What you do instead is put our one <script> line inside a Custom HTML tag, fire it on every page, and publish the container.
The names in bold below in the Google Tag Manager stages are Google's own, so they match what you see in the container. Take this route only if Google Tag Manager already runs on your site. If it does not, pasting the line straight into your site's HTML is fewer steps and one less thing to keep working.
| Option | Best for |
|---|---|
| Google Tag Manager | The container is already on every page, and whoever handles your marketing tags would rather this lived beside them. |
| The snippet, pasted into your site | You can edit the site's HTML or use its code box. Nothing else has to be published for the bubble to appear. |
Copy your snippet
In the left sidebar click Bots, then click your bot's row.
In the bot sidebar, under Go live, click Install.
In the Install code card, stay on the Generic
<script>tab.Click Copy.
The button reads Copied for a moment.
Create the Custom HTML tag
In Google Tag Manager, open the container for your website.
In the left-hand menu, click Tags.
Click New.
Click Tag Configuration.
Choose Custom HTML from the list of tag types.
Paste the snippet into the HTML box.
Paste it exactly as you copied it,
<script>tag and all.
Fire it on every page and save
Under the tag, click Triggering.
Choose All Pages.
Any narrower trigger puts the bubble on some pages and not others.
At the top of the page, replace Untitled Tag with a name you will recognise later.
Something like Adoomi chat widget does the job.
Click Save.
Publish the container
In the top right, click Submit.
Click Publish.
Name the version first if you keep a record of container changes.
Check it's live
Open your website in a new browser tab.
Look at the bottom-right corner of the page.
The chat bubble sits there, unless you moved it in Appearance.
Go back to your dashboard.
Loading your own site is what tells us the snippet is in place, so do it in this order.
If it didn’t work
I published the tag but there's no bubble on my site
- Check
- Open your site, right-click the page, choose View page source, and search that text for
gtm.js. - Fix
- No
gtm.jsmeans the container is not on that page, and a tag cannot fire where the container is not installed. Add the container code to your site, or skip Google Tag Manager and paste our line straight into the site's footer instead. - Resolved when
gtm.jsand the bubble both show up on the page.
The tag never fires
- Check
- In Google Tag Manager, click Preview, load your website in the window it opens, and look at the tag list.
- Fix
- If your tag sits under Tags Not Fired, the trigger is too narrow. Open the tag, click Triggering, choose All Pages, click Save, then Submit and Publish again.
- Resolved when
- The tag appears under Tags Fired in Preview, and the bubble is on the page.
Our consent tool is blocking the tag
- Check
- In Preview, check whether the tag stays unfired while consent is pending.
- Fix
- The tag fires once your consent tool allows it, which is a setting on your side. It may help to know what the chat window does: it sets no cookies and keeps nothing in the browser's local storage, and a conversation lives in that one tab until it closes. If you would rather not route it through consent tooling at all, paste our line straight into the site.
- Resolved when
- The tag fires and the bubble appears.
There are two chat bubbles on my site
- Check
- Search the page source for
widget.js. You will find it twice. - Fix
- The line is running from Google Tag Manager and from the site's own HTML. Pick one route and remove the other, then publish the container again if you removed the tag.
- Resolved when
- One bubble in the corner.
My dashboard still says Not installed yet
- Check
- Compare the address in Allowed domains (comma-separated) with the address in your browser bar when you visit your site.
- Fix
- Make them match, click Save, then open your live site in a new tab. We only see the install when a page on an allowed domain loads the snippet —
localhostnever counts, even if you allow it. If it still will not turn over, email hello@adoomi.ai with your website address and your container ID. - Resolved when
- The top bar shows Live on your site.
What this can’t do
- There is no Adoomi tag template in Google Tag Manager — the install is a Custom HTML tag holding our
<script>line. - Tags only fire on pages that already carry the container code — pages without it get no bubble.
- Saving a tag changes nothing until the container is published.
- A consent tool that holds back Custom HTML tags also holds back the bubble until the tag is allowed.
Next steps
Install Adoomi on any website
The direct route, if Google Tag Manager turns out to be more trouble than it saves.
Allowed domains explained
Why the bubble only loads on addresses you list, and how subdomains are covered.
The widget isn't showing on your site
What to do if a published tag still leaves the corner empty.