Add the chat widget to your site

Launch your agent on any site with the embed snippet.

1. Open your agent

   Go to the Embed tab.

2. Copy the embed code

   Use the snippet shown for your agent.

3. Paste it into your site

   Add it before the closing </body> tag.

Customize the widget

• Theme: light, dark, or system
• Position: bottom right or bottom left
• Preview the look before you publish

Authenticated users

If your site has logged-in users, call ConversionOsChat.setUser() after they sign in so conversations show their name, email, and avatar instead of "Visitor."

After login:

ConversionOsChat.setUser({
  id: "user-123",
  name: "John Doe",
  email: "john@example.com",
  avatarUrl: "https://example.com/avatar.jpg"  // optional
});

On logout:

ConversionOsChat.setUser(null);

You can call setUser as soon as the widget script is on the page; if the chat iframe is not ready yet, the data is sent automatically when it loads.

Controlling the widget

The embed exposes ConversionOsChat on the page. Use it to open/close the chat or show/hide the whole widget.

Example: hide the widget on a checkout page, then show it again on the next page:

ConversionOsChat.hide();   // on checkout
ConversionOsChat.show();   // when back on marketing or support pages

Example: open the chat from a "Contact support" button:

ConversionOsChat.open();