Quick start
Gerry is a voice layer for a site with a filterable catalog. The site adds one script tag; everything Gerry may do on it lives in a site map on our server, not in the site's code.
1. Have your search page ready
Before you open the panel, know the address of the page where visitors filter: /search, /products, /listings — whatever it is on your site. That is the one thing setup asks for first. See Setting Gerry up for the five steps in full, with screenshots.
2. Add the script
The panel's "Site & key" screen gives you this line, with your own key already in it. Paste it once, before the closing </body> tag, on every page where Gerry should appear.
<script src="https://katman-widget.vercel.app/gerry.js" data-key="pk_…" defer></script>The key is public by design — it is already sitting in your page's source. What protects your minutes is the allowed-origin list next to it in the panel: the browser sends the page's origin, which a page cannot forge, and the server checks it against that list. An empty list allows nothing.
3. What happens on the first click
Nothing runs until a visitor clicks the orb. The browser asks for the microphone first; no conversation is created and no minute is spent until it is granted. If the visitor refuses, the bubble says so and nothing else happens. Say what a visitor would say, in one sentence: "show me headphones under three hundred" — and watch the page's own filters answer.
Where things live
| On your site | One script tag. Nothing else, ever — no build step, no library, no CSS to import. |
|---|---|
| On our server | Your tenant: the key, the origin list, the assistant's name, persona, first sentence, languages and voices, the site map, the usage meter, the nightly checks. |
| In the browser | The widget: the face in the corner, the microphone, the six tools built from your map, the pointer that shows what Gerry is doing to the page. |
Limits to know on day one
- One tab, one conversation.
- A filter never reloads the page — see How a filter is applied for why and what that requires of your site.
- Gerry only ever navigates within your site's own origin. A link that resolves elsewhere is never followed.
- Plans cap both conversations and minutes a month; at either cap a new conversation is refused with one sentence, in the visitor's language. See Plans & limits.
Next: How it works explains map mode in one page, or jump straight to Setting Gerry up to walk the panel's five steps.
Questions: hello@heygerry.io. These pages describe what is built today; nothing here is a promise about what is not.