Documentation

Getting started with BotBloom

Build your first chatbot and put it on your website in under 10 minutes. No coding needed.

Quick Start

1

Create your account

Sign up for StackBloom and purchase a BotBloom plan. Go to your chatbot dashboard to create your first widget.

2

Create a chatbot widget

Click "Create Widget" and give it a name. Configure the bot's name, avatar, primary color, and welcome message to match your brand.

3

Build your conversation flows

Use the visual flow builder to design conversation paths. Add message nodes, question nodes with buttons, condition branches, and lead capture forms.

4

Configure AI responses (optional)

On Pro and Business plans, enable AI responses. Paste your FAQs or documentation into the knowledge base. The bot will use this context to answer questions that fall outside your defined flows.

5

Embed on your website

Copy the embed script from your widget settings and paste it into your website's HTML. The chatbot will appear in the corner of your page.

Embed Code

Add this script to any page where you want the chatbot to appear. Replace YOUR_WIDGET_KEY with the key from your widget settings.

<script
  data-widget="YOUR_WIDGET_KEY"
  src="https://cdn.stackbloom.io/bot.js"
  defer
></script>
Async loading • No page speed impact • Works on any website

Flow builder node types

The visual flow builder uses different node types to create conversation paths. Here's what each node does:

Message

Send a text message to the visitor. Supports markdown formatting and emoji.

Used for: Welcome messages, information, confirmations

Question

Ask a question with button options. Each button can lead to a different branch in your flow.

Used for: Multiple choice, routing, lead qualification

Input

Collect free-text input from the visitor. Can validate as email, phone, or plain text.

Used for: Collecting name, email, feedback

Condition

Branch the flow based on previous answers. Route conversations differently based on visitor responses.

Used for: Lead scoring, department routing, personalization

Action

Trigger an action like sending a webhook, capturing a lead, or handing off to a human agent.

Used for: CRM integration, email notifications, handoff

AI Response

Let the AI generate a response based on your knowledge base. Falls back gracefully if confidence is low.

Used for: FAQs, product questions, dynamic responses (Pro+)

AI knowledge base setup

On Pro and Business plans, you can enable AI-powered responses. Paste your FAQs, documentation, or product info into the knowledge base. The AI uses this context to answer visitor questions.

// AI Knowledge Base format (paste in widget settings)

# About Our Product
We sell handmade leather goods. Our products include
wallets, bags, belts, and accessories.

# Shipping
We ship worldwide. Standard shipping takes 5-7 days.
Express shipping takes 2-3 days.

# Returns
30-day return policy on all items. Items must be
in original condition.

# Pricing
Wallets start at $49. Bags start at $149.
Custom orders available on request.

Tips for better AI responses:

  • Use clear headings to organize topics
  • Include specific numbers (prices, dates, limits)
  • Write in a natural, conversational tone
  • Update the knowledge base when your information changes

Widget customization

Customize the chatbot widget appearance and behavior from your dashboard.

OptionDescriptionDefault
Bot NameThe name displayed in the chat header"Bot"
AvatarImage URL for the bot's avatarDefault icon
Primary ColorBrand color for the widget header and buttons#6366f1
PositionWhere the widget appears on the pageBottom-right
Welcome MessageFirst message shown when chat opens"Hi! How can I help?"
PlaceholderInput field placeholder text"Type your message..."
Auto-OpenAutomatically open chat after delayOff
Auto-Open DelaySeconds before auto-opening5 seconds
Collect EmailAsk for email before starting chatOn
Show On PagesLimit widget to specific pagesAll pages

Webhook integration

Configure webhooks to receive real-time notifications when leads are captured or conversations start. Set up webhook URLs in your widget settings.

// Webhook payload (sent on lead capture)
POST https://your-api.com/webhook

{
  "event": "lead_captured",
  "widget_id": "wgt_abc123",
  "lead": {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "phone": "+1234567890",
    "message": "I'm interested in the Pro plan"
  },
  "conversation_id": "conv_xyz789",
  "captured_at": "2026-02-23T14:30:00Z"
}

Need Help?

Can't find what you're looking for? Reach out to our support team.