1. AI Agent Installation
AI Agent Customer Support Docs
  • Default module
    • Product
      • Changelog
    • AI Agents
      • Create AI Agent
      • Edit AI Agent
      • Delete Agent
    • Leads
      • Lead Settings
      • Lead Report
    • AI Agent Installation
      • Overview
      • Custom Website
      • WordPress
      • Link WhatsApp with AI Agent
      • Setup New WhatsApp Account
      • Google Tag Manager
      • Shopify
      • Squarespace
      • Wix
      • Webflow
      • Bubble
      • PrestaShop
      • GoDaddy
    • Billing & Pricing
    • Partner
      • Partner Management
    • Roadmap
      • Upcoming Features
    • Intelligence Settings
      • Intelligence Settings
    • Advance Settings
      • Overview
      • Header & Labels
      • Widget Tabs
      • Lead Capture Form
      • Quick Questions
      • Custom CSS and JS
      • Branding & Tracking
      • Behaviour Settings
      • Consent & Overlay
    • Partner Dashboard
      • How to Create White-Label
      • License Management
    • Message Credits
      • Message Credits
  1. AI Agent Installation

Google Tag Manager

Use this guide if you manage scripts using Google Tag Manager (GTM).
Copy the Embed Code from your portal as described in Installation Overview.
Two embed methods are supported:
1.
Script-based loader (recommended): Adds an AI Agent bubble. The chat opens in an iframe popover when the visitor clicks the bubble.
2.
Iframe-based embed: Loads the AI Agent directly as an iframe appended to the page body (best for dedicated pages).

Best placement#

Script-based loader: Use a Custom HTML tag fired on All Pages.
Iframe-based embed: Use only on selected pages where you want a direct embedded chat experience.
Important:
The embed code appends to document.body. In GTM, make sure the tag fires after the page is ready (see Trigger notes below).

Script-based loader (AI Agent Bubble)#

1.
Open Google Tag Manager.
2.
Go to Tags → New.
3.
Choose Tag Configuration → Custom HTML.
4.
Paste the Script-based loader code.
5.
Click Triggering and select All Pages.
6.
Save the tag.
7.
Click Submit and Publish your GTM container.

Recommended Trigger settings#

If you face loading issues, change the trigger timing:
Use All Pages but fire on Window Loaded (or ensure your GTM setup runs after DOM is ready), because the embed code appends to document.body.

Iframe-based embed (Direct AI Agent Chat)#

Recommended only when you want the embedded chat on specific pages.
1.
Create a new Custom HTML tag.
2.
Paste the Iframe-based embed code.
3.
Set a trigger for specific pages (example: Page URL contains /support).
4.
Save.
5.
Submit/Publish the GTM container.
Notes:
This method appends the iframe to the page body and is best used on pages where full-height chat is acceptable.
To control size, adjust iframe.style.width and iframe.style.height in the code (example: 600px, 80vh, 100vh).

Verify installation#

1.
Open your website in an incognito/private window.
2.
Confirm the bubble or embedded AI Agent loads.
3.
Send a test message and confirm replies.

Troubleshooting#

Widget not visible#

Confirm the GTM container is installed on the website and the container version is published.
Use GTM Preview mode to confirm the tag fires.
If the tag fires but nothing appears, try firing the tag later (for example on Window Loaded) since the embed appends to document.body.
Check if consent mode, ad blockers, or script blocking prevents the tag from running.

Widget visible but not responding#

Check browser console for blocked requests (ad blockers, CSP rules, network blocks).
Confirm the latest GTM container version is published.
Confirm the correct pid, cid, and api-domain values are used.

Duplicate widget#

Ensure only one GTM tag contains the embed code.
Confirm the tag is not firing multiple times due to multiple triggers or duplicate containers on the site.
Modified at 2026-02-19 07:22:10
Previous
Setup New WhatsApp Account
Next
Shopify
Built with