Skip to main content

Quick Start

Add this script tag to any page where you want the chat widget to appear:
That’s it. A floating chat bubble will appear in the bottom-right corner of your page, styled with your AI teammate’s branding.

Find Your Bot ID

  1. Open your AI teammate
  2. Open Settings, then Overview under Channels
  3. Your Bot ID is shown in the embed code snippet. You can also copy it with Copy AI teammate ID

Data Attributes

You can configure the widget directly via data attributes on the script tag:

Dock layout

Use dock mode when you want the widget to feel like the hosted chat input: a centered prompt bar at the bottom of the page that expands into a wider chat panel.
Dock mode uses your placeholder text and conversation starters when available.

Framework Setup

Programmatic Initialization

For more control, initialize the widget via JavaScript:

How It Works

  1. The script fetches your AI teammate’s branding (accent color, avatar, greeting messages) from the BoostGPT API
  2. It injects a floating bubble button styled with your AI teammate’s accent color and avatar
  3. Greeting messages from your branding settings appear as stacked chat bubbles above the button
  4. When clicked, an iframe opens with your AI teammate’s full chat experience
  5. The chat supports all features: streaming, tools, file uploads, workspaces, and custom interfaces

Enable the Widget

Before the embed code appears, enable the widget in your AI teammate’s settings:
  1. Go to Branding → Design tab
  2. Scroll to the Chat Widget section
  3. Toggle Enable Widget on
  4. Configure position and auto-open behavior