Quickstart

Prerequisites

Before you begin, make sure you have:

A BoostGPT account (sign up free)
An AI agent created and trained with your content
Access to your website’s code

Add this script to your website:

<script src="https://embed.boostgpt.co/widget.js" data-bot-id="YOUR_AGENT_UUID"></script>

Replace YOUR_AGENT_UUID with your agent’s UUID from the dashboard. The bubble appears in the bottom-right corner and opens the full agent chat experience — streaming, tools, and file uploads all work out of the box.

Step 2: Choose an Open Style

Set data-open-style to control how the chat opens:

<script
  src="https://embed.boostgpt.co/widget.js"
  data-bot-id="YOUR_AGENT_UUID"
  data-open-style="dock"
  data-position="bottom-left"
></script>

normal (default) — a floating chat window opens from the bubble
dock — a centered prompt bar that expands into a wider chat panel

See Configuration for greetings, conversation starters, auto-open, and branding options.

Step 3: Identify Your Users (Optional)

If visitors are logged in, sign a JWT on your backend so conversations are tied to the right user and history persists across sessions:

// YOUR SERVER
const token = jwt.sign({
  email: 'user@example.com',
  name: 'Jane Doe',
  external_id: 'ext-123',
}, SSO_SECRET, { expiresIn: '1h' });

<script
  src="https://embed.boostgpt.co/widget.js"
  data-bot-id="YOUR_AGENT_UUID"
  data-user-token="SIGNED_JWT"
></script>

Generate the SSO secret on your agent’s Deploy page. See the SSO guide for full backend setup.

Step 4: Test It

Open your website in a browser
Click the chat bubble
Ask a question your agent was trained on — you should get a streamed answer
Check the Conversations page in the dashboard to see the transcript

Next Steps

Widget Configuration

All available options

Use Case Guides

Real-world implementation examples

Getting Started

Choose Your Path

Providers & Models

Prerequisites

Step 1: Add the Chat Widget

Step 2: Choose an Open Style

Step 3: Identify Your Users (Optional)

Step 4: Test It

Next Steps

Widget Configuration

Use Case Guides

​Prerequisites

​Step 1: Add the Chat Widget

​Step 2: Choose an Open Style

​Step 3: Identify Your Users (Optional)

​Step 4: Test It

​Next Steps

Widget Configuration

Use Case Guides

Prerequisites

Step 1: Add the Chat Widget

Step 2: Choose an Open Style

Step 3: Identify Your Users (Optional)

Step 4: Test It

Next Steps