Google Tag Manager

You can roll out homie AI through Google Tag Manager (GTM) without touching theme code. This is ideal when several properties share the same container, or when you manage all of your site tags in one place.

Before you start, make sure you have:

An assistant created on the platform
Your embed script copied from the assistant’s Publish area
Access to a Google Tag Manager container on your site

Add a Custom HTML tag

Copy your embed script

Open your assistant on the platform, go to its Publish area, choose Google Tag Manager, and copy the script. It already contains your chatbotId.

Platform Publish area showing the copyable script snippet

Create a new Custom HTML tag

Sign in at tagmanager.google.com, select your container, then choose Tags → New → Custom HTML.Paste the embed script into the HTML field. The Tag Manager version configures the widget through window.homieBotConfig and injects it for you, because Custom HTML tags load scripts in a way that prevents reading attributes directly:

<script>
  (function () {
    window.homieBotConfig = {
      chatbotId: "YOUR-CHATBOT-ID",
      domain: "https://chat.yourhomie.ai"
    };
    var script = document.createElement("script");
    script.src = "https://cdn.yourhomie.ai/embed.min.js";
    script.defer = true;
    if (document.readyState === "loading") {
      document.addEventListener("DOMContentLoaded", function () {
        document.body.appendChild(script);
      });
    } else {
      document.body.appendChild(script);
    }
  })();
</script>

Set the trigger to All Pages

Choose the All Pages trigger so the chat bubble loads site-wide.

Google Tag Manager with the All Pages trigger selected for the homie tag

Submit and publish

Click Submit, then Publish. GTM deploys the tag immediately.

Refresh your site. The homie chat bubble appears in the bottom-right corner. Open it and send a test message.

Use GTM’s built-in environments to test the tag in a preview before you publish to production.

Troubleshooting

Tag fires but no bubble? Disable any script blockers and clear your cache.
Only on specific pages? Adjust the trigger to a Page View rule that matches the pages you want.
Multiple environments? Use GTM environments to validate before going live.

For deeper configuration and methods, see the Client API.

Next steps

Client API

Configure the widget and call methods from your site.

Installation overview

Compare install methods for every platform.

Shopify Shopware

Get Started

Assistants

Knowledge

Chat tags

Product Questions

Tools

Integrations

Settings

Account

Add a Custom HTML tag

Troubleshooting

Next steps

Client API

Installation overview

​Add a Custom HTML tag

​Troubleshooting

​Next steps

Client API

Installation overview

Add a Custom HTML tag

Troubleshooting

Next steps