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:
| Context | CTA 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
}
});