Get started

Install the widget

One script tag, any site. The widget loads asynchronously, doesn't block render, and weighs ~6 KB gzipped.

Copy the snippet

Open your agent in the dashboard, go to Deploy, and copy the snippet (don't retype it — the src URL and agent ID are pre-filled for you). It looks like:

<script
  src="https://agentmatica.com/loader.js"
  data-widget-src="https://agentmatica.com/widget.js"
  data-bot-id="YOUR_BOT_ID"
  id="agentmatica-widget-script"
  defer
></script>

Where to paste it

Anywhere before </body>. Most teams put it in the site's root layout so it loads on every page.

Shopify

Theme editor → Edit code → theme.liquid → paste just before </body>. Use the Liquid snippet so logged-in shoppers are recognized without re-entering order details:

<script
  src="https://agentmatica.com/loader.js"
  data-widget-src="https://agentmatica.com/widget.js"
  data-bot-id="YOUR_BOT_ID"
  id="agentmatica-widget-script"
  data-amk-logged-in="{% if customer %}1{% else %}0{% endif %}"
  data-amk-customer-token-url="/apps/agentmatica/customer-token"
  defer
></script>

Requires Connect Shopify (OAuth) on the agent and the Agentmatica Partner app App Proxy configured (see Shopify integration). Classic customer accounts only for logged-in identity.

WordPress

Use any “custom code” plugin (e.g. WPCode), or paste into your theme's footer.php. If you're running the wordpress/mcp-adapter, see WordPress integration for the matching MCP config.

Next.js / React

Use next/script with strategy afterInteractive:

import Script from "next/script";

<Script
  src="https://agentmatica.com/loader.js"
  data-widget-src="https://agentmatica.com/widget.js"
  data-bot-id="YOUR_BOT_ID"
  strategy="afterInteractive"
/>

Plain HTML / static sites

Drop the snippet anywhere. The deferattribute means order doesn't matter for FCP.

No site yet? Use the hosted chat page

The Share link section of the same Deploy tab can give your agent a public URL — visitors chat in a full-page UI with no embed, no setup, and no account. Toggle on Hosted chat page and pick a slug (lowercase letters, numbers, and hyphens; 3–48 characters). Handy for DMing a prospect or testing on a phone before the widget ships.

Customizing appearance

Brand color, welcome copy, suggested prompts, and display mode (bubble vs spotlight) all live in Agent → Widget appearance. Changes propagate within a minute — the widget fetches its config live, not at build time.

Verifying it works

• Open your site in an incognito window.
• You'll see the chat bubble in the bottom-right (default).
• Open it and ask any question your indexed content covers.
• Watch the new conversation appear in Agent → Conversations in the dashboard.
• The Widget statuscard on the Deploy tab flips from “We haven't seen the widget yet” to confirmed once the script loads on your domain.