Embedding the Widget

Copy the production snippet from Settings → Widget → Installation and security and place it before the closing </body> tag on every page where chat should be available.

<script
  src="https://cdn.convor.io/widget.js"
  data-key="convor_wpk_..."
  async
></script>

data-key is the public widget key for the selected site. It is expected to be visible in browser code and is not a secret organization API key.

The hosted widget.js build already knows the production API, iframe, and realtime endpoints. Do not copy those service addresses into the embed tag or maintain them in your application configuration.

What the embed code controls

The embed code identifies which Convor site configuration to load. Appearance, visitor-facing content, availability, pre-chat fields, triggers, and other widget settings are managed in the Convor dashboard and loaded when the widget starts.

If you change a widget setting in the dashboard, you do not need to replace the embed code.

Browser API

The same script exposes window.Convor for application integrations such as prefilling visitor data, identifying a signed-in customer, synchronizing SPA routes, opening or closing chat, and listening for widget events.

await Convor.ready();

await Convor.setUser({
  name: currentUser.name,
  email: currentUser.email,
});

See the Widget JavaScript API for the supported browser methods. Endpoint configuration is not part of the production browser integration contract.