Respos·ai← Back to journal
§ Docs · Embed

Website embed (script tag).

Drop one script tag on any page and a floating chat widget appears automatically.

The snippet

Find your agent's unique snippet on the Deploy tab inside the dashboard:

<script src="https://resposai.com/embed/YOUR_TOKEN" async></script>

Replace YOUR_TOKEN with the token shown in your Deploy tab. Paste the tag anywhere in your HTML — before </body> is conventional.

What the script does

  • Injects a small floating ✺ button in the bottom-right corner.
  • Opens an iframe to the Resposai widget when clicked.
  • Passes messages to your agent and streams replies back.
  • Stores a stable visitor ID in localStorage so conversations can be linked across page refreshes.

Customising the button position

You can override the button's position with a data-position attribute:

<script
  src="https://resposai.com/embed/YOUR_TOKEN"
  data-position="bottom-left"
  async
></script>

Accepted values: bottom-right (default), bottom-left.

Allowed domains

If you've configured allowed domains, the agent will reject requests from any origin not on the list. This prevents others from embedding your agent on their sites.

Alternative: inline iframe

If you want the chat to appear inline instead of as a floating overlay, see the inline iframe guide.


Prefer API access? See the JSON API guide.