Skip to Content
Widget

Widget

Each agent can have its own widget copy and appearance. Configure the title, subtitle, welcome message, placeholder, launcher style, launcher position, brand color, and logo URL.

Runtime model

The widget is designed as a hybrid script and iframe runtime:

  • widget.js inserts the launcher and chat iframe.
  • The iframe contains the conversation UI.
  • Configuration is passed to the iframe with postMessage.
  • The host page stays isolated from chat UI state.

Host page behavior

The script reads the agent ID, inserts the floating launcher, opens and closes the iframe, and keeps widget state separate from the host page. This keeps installation lightweight and avoids CSS conflicts with the website.