Widget Embed

Settings → Widget Embed manages keys for the embeddable AI chat widget you can drop onto any website — a floating chat bubble that lets visitors talk to one of your AI agents without logging in.

Why it matters

The widget brings PeakCommerce's conversational AI to pages you don't host inside the platform — a marketing site, a help center, a landing page. Visitors can ask product inquiries, get support, and take commerce actions in the same chat, with no account required.

Create and embed

1. Create a widget key. Choose which AI agent powers it (the agent's instructions and tools define what the chat can do) and customize its appearance.

2. Copy the embed snippet — a small script tag scoped to that key.

3. Paste it into your site's HTML, just before the closing </body> tag.

4. Reload the page; the widget appears as a floating chat bubble.

How to use it

• Use separate keys for different sites or agents so you can tune behavior — or revoke one — independently.

• Pick the agent deliberately: a support-focused agent and a sales/commerce agent give visitors very different experiences.

Gotchas and security

• The key is embedded in public client-side HTML, so it is visible to anyone. It authorizes only the scoped widget chat — never reuse an API key here.

• Visitors are unauthenticated, so the powering agent should expose only actions safe for anonymous users.

• Removing or revoking the key disables the widget on every site using that snippet.