Book a build call
Back to Help
Guide

Put your agent on your website

5 min read

Your agent can greet the people who visit your own website. 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, and the rest of this guide is ahead of you.

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, 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. The chat bubble appears 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.

  1. 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 both your-site.com and www.your-site.com, add both.
  2. 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.
  3. Press Verify and activate. When the check passes, the address is marked active and the chat on your site starts answering. If it fails, the page says why; fix the file and press it again.

Step 3: switch on speaking first

Once an address is active, a switch appears beside it: Speak first on this site. Press it to turn it on. Then go back to Step 1, press Copy code again, and replace the tag on your site with the new one: after verification the tag carries the extra setting that lets the agent speak first. Press the switch again to turn it off.

If the agent is not public, the switch tells you: Make your agent public so it can speak.

If you do not see the switch, speaking first is not switched on for your account yet. The chat bubble still works.

What a visitor then meets

With speaking first off, visitors see a chat bubble in the corner of the page and the agent waits for them to open it.

With it 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 out loud 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 × in the corner closes the panel and brings the chat bubble back.

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 bubble 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.
  • The old tag is on the site. If speaking first is on but the agent only shows a bubble, copy the tag again from Step 1 and replace the one on your site.
  • Your site sets a Content-Security-Policy header. A strict policy stops the browser loading the tag at all. Your site's script-src has to allow https://app.netshow.ai so the tag can load, connect-src so the chat can answer, and frame-src so the speaking panel can open.

Next: Find it on the shelf.

Still stuck?

The longer documentation covers models, voice, knowledge, and workflows in depth.

Open the documentation