§ 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
localStorageso 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.