Configuration

Branding Settings

The widget automatically inherits your agent’s branding. Configure these in Branding → Design and Content tabs:

Setting	Where	Widget Effect
Accent Color	Design tab	Bubble background color
Background Color	Design tab	Frame border/shadow tinting
Theme	Design tab	Light/dark tooltip styling
Bot Avatar	Agent settings	Bubble icon
Message Greetings	Content tab	Stacked greeting bubbles above the button
Conversation Starters	Content tab	Quick-action buttons in the chat
Input Placeholder	Content tab	Chat input hint text

These are configured in Branding → Design tab under the Chat Widget section:

Position

Choose where the bubble appears on the page:

Bottom Right (default)
Bottom Left

Auto Open

Automatically open the widget after a delay when the page loads.

Enable/Disable toggle
Delay — seconds before the widget opens (1–60, default 5)

Open Style

Choose how the chat opens when a visitor clicks the bubble:

Normal — opens the current floating chat window.
Agent dock — shows a centered input-style launcher at the bottom of the page and expands into a wider chat panel.

Agent dock mode is useful when the widget should feel closer to the hosted agent experience: always visible as a prompt bar, less interruptive than a bubble, and strong for marketing pages that invite visitors to ask a question directly. The default desktop dock width is 720px. You can change it in Branding → Chat Widget or by passing data-dock-width / dockWidth in the embed setup.

Greeting Bubbles

The widget shows your Message Greetings (from Content tab) as stacked chat bubbles above the floating button. Each greeting appears as a separate message card. Clicking any greeting bubble opens the widget. To configure greetings:

Go to Branding → Content tab
Enable Message Greetings
Add 1–4 greeting messages

If greetings are disabled, only the floating bubble button is shown.

Passing Context

You can pass metadata from your website to the agent conversation:

boostgpt.init({
  botId: 'YOUR_BOT_UUID',
  metadata: {
    page: 'pricing',
    plan: 'pro',
    userId: '12345',
  },
});

Metadata is available to the agent as conversation context, allowing it to personalize responses based on what page the user is on or what product they’re viewing.

Mobile Behavior

On screens narrower than 480px, the widget iframe expands to full-screen when opened, providing a native app-like experience.

Getting Started

Choose Your Path

Providers & Models

Branding Settings

Widget-Specific Settings

Position

Auto Open

Open Style

Greeting Bubbles

Passing Context

Mobile Behavior

​Branding Settings

​Widget-Specific Settings

​Position

​Auto Open

​Open Style

​Greeting Bubbles

​Passing Context

​Mobile Behavior

Branding Settings

Widget-Specific Settings

Position

Auto Open

Open Style

Greeting Bubbles

Passing Context

Mobile Behavior