Deploying Your Agent
Widget Embed

Widget Embed

The Zimmer widget loads your agent as a floating button on any webpage. Users click it to open a full chat experience without leaving your site.

Setup

  1. Open your agent → Settings → Deploy
  2. Copy the Widget Embed Code
  3. Paste it before the </body> tag on your website
<script
  src="https://cdn.zimmer.ai/widget.js"
  data-agent-id="your-agent-id"
  defer
></script>

For site-wide placement, add it to your layout template or global script field in your website builder (Webflow, WordPress, Shopify all support this).

Behaviour

  • A floating button appears bottom-right
  • Clicking opens the agent in an overlay
  • Closing preserves the conversation — users can reopen and continue

Starting Over

If Allow "Start Over" is enabled in agent settings, users can type "start over" or "reset" at any point to return to the beginning of the conversation journey. The welcome message and original quick reply buttons reappear.

A visual "Conversation restarted" divider appears in the chat. All previous messages remain visible — only the journey position resets.

New Conversation

If New Conversation Button is enabled in agent settings, a pencil icon appears in the widget header after a few message exchanges. Clicking it creates a completely new conversation. The previous conversation is preserved in your Conversations dashboard.

Product card CTAs

When a product card CTA is clicked inside the widget, a postMessage fires to your page instead of navigating away:

window.addEventListener('message', (event) => {
  if (event.data?.type === 'zimmer:cta_click') {
    console.log(event.data.url);           // product URL
    console.log(event.data.productTitle);  // product name
  }
});