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
- Open your agent → Settings → Deploy
- Copy the Widget Embed Code
- 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
}
});