Introduction

Chatonbo is an AI-powered chatbot platform that lets you embed a smart chat widget on any website in minutes — no coding required.

Train your bot with your own knowledge base (URLs, PDFs, FAQs), customize its personality and branding, and start engaging visitors immediately. Chatonbo handles sales qualification, customer support, lead capture, and more — all on autopilot, 24/7.

This documentation covers everything from initial setup to advanced API integration.

Quick Start

Get your first chatbot live in under 5 minutes.

Embed Code

Add the following script tag to your website — just before the closing </body> tag. Replace YOUR_BOT_ID with your bot's unique identifier found in the bot settings.

<script
  src="https://chatonbo.com/widget/chatonbo-widget.js"
  data-bot-id="YOUR_BOT_ID"
  data-api-url="https://chatonbo.com/api"
  data-open-delay="3000"
></script>

Configuration Options

Customize the widget behavior using data-* attributes on the script tag.

Trigger Settings

You can programmatically control the widget from JavaScript once it has loaded.

// Open the chat widget
window.Chatonbo.open();

// Close the chat widget
window.Chatonbo.close();

// Toggle open/closed
window.Chatonbo.toggle();

Knowledge Base

Your bot learns from the sources you provide. You can add, update, or remove sources at any time — the bot re-trains automatically.

Authentication

All API requests must include a valid Bearer token in the Authorization header. You can generate API tokens from Settings → API Keys in the dashboard.

Authorization: Bearer YOUR_ACCESS_TOKEN

Keep your API token secret. Never expose it in client-side code or public repositories. Rotate tokens immediately if they are compromised.

Bots

Manage your bots programmatically via the REST API.

# List all bots
GET /api/bots

# Get a single bot
GET /api/bots/:botId

# Create a new bot
POST /api/bots
Content-Type: application/json

{
  "name": "Support Bot",
  "systemPrompt": "You are a helpful assistant...",
  "welcomeMessage": "Hi! How can I help you?"
}

Chat

Send messages to a bot and receive AI-generated responses.

POST /api/chat/:botId/message
Content-Type: application/json

{
  "sessionId": "sess_abc123",
  "message": "What are your pricing plans?"
}

# Response
{
  "reply": "We offer three plans: Free, Pro ($29/mo)...",
  "sessionId": "sess_abc123"
}

Leads

Retrieve leads captured by your bots.

# List leads for a bot
GET /api/bots/:botId/leads

# Response
{
  "leads": [
    {
      "id": "lead_xyz",
      "name": "Jane Smith",
      "email": "jane@example.com",
      "phone": "+1 555 000 1234",
      "createdAt": "2026-03-10T12:00:00Z"
    }
  ]
}

Webhooks

Chatonbo sends HTTP POST requests to your webhook URL when events occur. Configure webhook URLs in Settings → Webhooks.

Example payload for the lead.created event:

{
  "event": "lead.created",
  "timestamp": "2026-03-10T14:32:10Z",
  "botId": "bot_a1b2c3d4",
  "lead": {
    "id": "lead_xyz789",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1 555 123 4567",
    "source": "widget",
    "sessionId": "sess_qrs456"
  }
}