Quick Start
Add this script tag to any page where you want the chat widget to appear:Find Your Bot ID
- Go to your agent dashboard
- Navigate to Deploy
- Your Bot ID is shown in the embed code snippet
Data Attributes
You can configure the widget directly via data attributes on the script tag:Agent Dock Layout
Use dock mode when you want the widget to feel like the hosted agent input: a centered prompt bar at the bottom of the page that expands into a wider chat panel.Framework Setup
Programmatic Initialization
For more control, initialize the widget via JavaScript:How It Works
- The script fetches your agent’s branding (accent color, avatar, greeting messages) from the BoostGPT API
- It injects a floating bubble button styled with your agent’s accent color and avatar
- Greeting messages from your branding settings appear as stacked chat bubbles above the button
- When clicked, an iframe opens with your agent’s full chat experience
- The chat supports all features: streaming, tools, file uploads, workspaces, and custom interfaces
Enable the Widget
Before the embed code appears on your Deploy page, enable the widget in your agent’s settings:- Go to Branding → Design tab
- Scroll to the Chat Widget section
- Toggle Enable Widget on
- Configure position and auto-open behavior