Deploying Your Agent
Overview

Deploying Your Agent

Zimmer agents can be deployed in two ways: as a standalone landing page or as an embedded widget on your website. Both are available once you publish.

Publishing

Agents start in Draft state. Go to Settings → Deploy and click Publish to go live. You can unpublish at any time without losing your configuration.

See Publishing for details on the draft/publish workflow.

Landing page

Every published agent gets a public URL you can share directly — in emails, social posts, QR codes, or ad campaigns.

See Landing Pages.

Widget embed

Embed your agent as a floating chat button on any webpage with a single <script> tag.

See Widget Embed.

Product card CTAs

When your agent shows a product card, the CTA button behaviour depends on the deployment context:

ContextCTA behaviour
Standalone page (desktop)Opens product URL in a new tab
Standalone page (mobile)Opens a bottom sheet with product details
Embedded widget (iframe)Fires a postMessage event to the parent page

To handle product card clicks from the widget on your own page:

window.addEventListener('message', (event) => {
  if (event.data?.type === 'zimmer:cta_click') {
    const { url, productTitle } = event.data;
    // handle navigation or modal however you like
  }
});