Skip to main content
When your agent is ready, add it to any website via link, iframe, or chat bubble. The Embed/Install screen gives you three ready-to-use options, each with the snippet filled in for your agent. Open Channels & API → Embed/Install from the agent sidebar.
The Embed/Install screen with the Share Link, iframe, and Chat Bubble snippets.

​
Prerequisites

  • An agent that’s tested and ready (see Sandbox).
  • Access to edit your website’s HTML (for the iframe and chat bubble options).
In the snippets below, <AGENT_ID> is filled in automatically for your agent — copy the snippet directly from the Embed/Install screen rather than retyping it.
The fastest way to share your agent: a hosted page you can send in an email, link from a button, or post anywhere — no code required. 
https://chat.a2v2.ai/<AGENT_ID>
Anyone who opens the link chats with your agent on its own hosted page. A floating button in the corner of your site that opens the chat when clicked. This option comes in two parts.
1

Add the widget script to your head

Paste this into your page’s <head>:
<script src="https://chat-widget.a2v2.ai/embed.js"></script>
2

Add the config to your body

Paste this into your page’s <body>:
<script>
  window.A2V2WidgetConfig = { chatbotId: "<AGENT_ID>" };
</script>
3

Publish and reload

Publish your site and reload — the chat bubble appears. Add both snippets to every page where you want the bubble.
The widget loads inside an isolated container (a Shadow DOM), so it won’t clash with your site’s styles, and it won’t be affected by them.

​
Option 3 — Inline iframe

Embed the chat directly inside a page (for example, a dedicated “Help” page). Copy the <iframe> snippet and place it in your page’s HTML where the chat should appear. 
<iframe src="https://chat.a2v2.ai/<AGENT_ID>" width="100%" allow="clipboard-write; microphone" sandbox="allow-scripts allow-same-origin allow-popups allow-forms" style="height: 100%; min-height: 700px" frameborder="0"></iframe>

​
Which should I use?

Use the…When you want…
Share LinkTo send your agent as a link, with nothing to install.
Chat bubbleA site-wide assistant available on every page.
Inline iframeThe chat embedded into a specific page or layout.

​
Tips

  • Add the chat bubble snippet to your global template/footer so it appears everywhere at once.
  • For platforms like WordPress, Webflow, or Shopify, paste the snippet into the theme’s “custom code” / “footer code” area.
  • Re-test in the Sandbox before embedding so visitors get the final experience.

​
Troubleshooting

Confirm the snippet is before </body>, that chatbotId is present, and that your site doesn’t strip <script> tags. Check the browser console for errors.
The widget loads its own font and isolates its styles. If your site enforces a strict Content-Security-Policy, allow the widget’s font/script sources.
Your site or CDN may be caching the page. Hard-refresh, and clear any site/CDN cache after embedding.

Appearance

Visibility

Test your agent