Add chat to your website - Osvi AI Docs

This guide adds a chat launcher to your website with one script tag. It uses anonymous chat; for signed-in customers, see Logged-in users after this.

1. Turn it on and allow your site

In the chat agent, open Channels → Web widget:

Switch Anonymous usage on. It is off by default, and while it is off the widget does not appear.
Under Allowed websites, add your site’s exact origin, for example https://shop.example.com. To try it on your computer first, tick Allow localhost for testing.
Press Save at the top right. Nothing is saved before that.

Every setting in the pane is explained in Dashboard settings. Copy the snippet from Add it to your site → Website in the same pane, or use this one with your agent’s ID (the agent_… value shown under the agent name). Put it near the end of <body>.

<script>window.OsviChat=window.OsviChat||{q:[],open(){this.q.push(['open'])},close(){this.q.push(['close'])},toggle(){this.q.push(['toggle'])}};</script>
<script async data-agent="agent_yourAgentId" src="https://cdn.jsdelivr.net/npm/@osvi-ai/chat@0.1/dist/widget.js"></script>

The @0.1 URL always serves the latest 0.1.x release. To pin an exact version or add Subresource Integrity, see Production setup.

3. Check it works

Open a page of your site (or http://localhost:… with localhost allowed). The launcher appears in the bottom-right corner; open it and send a message. If the launcher does not appear, see Troubleshooting.

Next

Change the launcher, colours and header: Customise the widget.
Before going live, read Security and limits and Production setup.