Your agent can greet the people who visit your own website, out loud and with its own face. It takes one tag pasted into your site and one proof that the site is yours. This guide walks the page that hands you both.
Before you start
- The agent is published. A private agent does not answer anyone on your site. If you have not pressed Publish agent yet, Publish it covers that first.
- You can edit your site's code, or at least add a custom code block to it.
- Your site runs on https://. Plain http:// addresses are refused.
Open the embed page
From the dashboard, open your agent's Deploy page and press Open Embed Kit. The page that opens is headed "Put your agent's name on your own website" and has two steps.
If your Deploy page has no Open Embed Kit button, the embed page is not switched on for your account yet.
Step 1: copy the tag
The first card is headed Paste this tag into your website. Press Copy code; the button reads Copied for a moment when it worked. Keep every value in the tag exactly as written: it carries your agent's name, face and speak-first setting, and the chat looks your agent up by it.
Paste it, on one line and unchanged, just before </body> on each page where you want the agent.
On a plain HTML page that
looks like this:
<!doctype html>
<html>
<head>
<title>Our shop</title>
</head>
<body>
<h1>Welcome</h1>
<!-- paste the tag from Step 1 here -->
</body>
</html>
If your site is made with a site builder, look for its custom code, embed or footer code block and paste the tag there, set to load on every page you want the agent on.
Pasting before you verify breaks nothing. A small button appears in the corner and, until your site is verified, tells visitors the door is closed instead of replying.
Step 2: add your site's address and verify it
The second card is headed Add your website and verify it.
- Type your site's address into Website address, for example
https://your-site.com. The address only, no page path. Press Request this site. It joins the list marked pending. If your site answers on bothyour-site.comandwww.your-site.com, add both. - Under the address, open Verify ownership and activate chat. It shows a file address on your
site, ending in
/.well-known/netshow-origin.txt, and the exact text that file must hold. Publish that text file at that address. It has to open directly, without redirecting. - Press Verify and activate. When the check passes, the address is marked active and your agent starts greeting visitors on your site. If it fails, the page says why; fix the file and press it again.
Step 3: your agent greets first
Verify your site and your agent greets visitors out loud with its face. There is nothing more to copy: the tag from Step 1 is the whole setup.
Beside each active address sits a switch, Speak first on this site, and it is already on. Switch it off for a quiet bubble; the tag on your site stays as it is.
If the agent is not public, the switch tells you: Make your agent public so it can speak.
What a visitor then meets
With speaking first on, a panel docks at the bottom right with the agent's face, and the greeting appears as a caption straight away. Browsers keep a page silent until the visitor taps or presses a key, so the greeting is spoken from their first tap. The browser asks the visitor's permission before the agent can hear them; it listens only if they allow it. The panel's Menu holds Chat (for typing instead), Mute replies and Stop listening. The × closes the panel and brings back the corner button, which wears your agent's face when it has one.
With speaking first switched off, visitors see that small button in the corner of the page, and the agent waits for them to open it.
How to take it off
On the embed page, press the × beside the address in the list (its label reads "Withdraw" and the address). The page confirms the address has been withdrawn, and the chat on that site stops answering. Removing the tag from your site takes the agent away as well.
If nothing shows
- The address is still pending. Open Verify ownership and activate chat and finish the
check. Make sure the address you added matches the one in your browser's bar, including
www.. - The agent is private. Publish it from the Deploy page.
- An older tag is on the site. If the switch is on but the agent only shows a bubble, replace that tag once with the one from Step 1; from then on the switch alone decides.
- Your site's Content-Security-Policy header blocks the tag; add the sources below.
Add each NetShow source below to the same directive of your site's Content-Security-Policy:
script-src https://app.netshow.ai;
connect-src https://app.netshow.ai;
img-src https://app.netshow.ai;
frame-src https://app.netshow.ai;
media-src blob:;
A tag that names the alternate host https://claude.netshow.ai needs it in the same places. A tag with a realtime voice mint URL also needs https://api.openai.com in connect-src.
Next: Find it on the shelf.