Bots

Bots are the core of Chatbot Platform. They connect your AI backends to messaging platforms, manage conversations, and provide a seamless experience for your users.

Overview

A bot is a configured instance that:

Connects to Channels: Links to one or more messaging platforms (Telegram, Slack, Discord)
Uses Integrations: Forwards messages to AI backends for response generation
Manages Conversations: Tracks message history and context
Applies Behaviors: Controls typing indicators, message detection, and response formatting

Creating a Bot

Navigate to Bots

From your dashboard, click Bots in the sidebar.

Fill in Details

Click Create Bot and provide:

Name: A friendly name for internal reference
Description: Optional description of the bot’s purpose

Configure Settings

After creation, you’ll see the bot overview where you can configure behaviors, add integrations, and connect channels.

Bot Components

Behaviors

Control how your bot interacts with users:

Typing Indicators

Show “thinking” messages while generating responses

Should Respond Detection

Determine which messages belong together in a conversation

Integrations

Connect your bot to AI backends:

Webhook Setup

Configure connections to OpenAI, Anthropic, or custom APIs

A/B Testing

Compare multiple AI backends with weighted distribution

Custom Headers

Add authentication and custom headers to requests

Channels

Deploy your bot to messaging platforms:

Connect to Telegram with bot tokens

Slack

Integrate with Slack workspaces

Discord

Deploy to Discord servers (coming soon)

Conversations

Manage message history and context:

Conversation Overview

View and manage bot conversations

Message History

Configure context window size

Default Integration

Every bot comes with a default “echo” integration that simply returns the user’s message. This is useful for:

Testing channel setup before connecting a real AI backend
Debugging webhook delivery
Understanding message flow

Replace the echo integration with a real AI backend when you’re ready.

Multiple Channels

A single bot can be connected to multiple channels simultaneously. This allows you to:

Deploy the same bot across Telegram, Slack, and Discord
Use one AI backend for all platforms
Maintain separate conversation contexts per platform
Centralize bot management

Bot Settings

Configure these settings for each bot:

Setting	Description	Default
Name	Display name for internal reference	Required
Description	Optional purpose description	Empty
Typing Indicators	Show “thinking” messages	Enabled
Message Detection	Conversation grouping strategy	Platform-specific
Context Window	Number of messages to include	10

API Access

Manage bots programmatically using the API.

Create a bot via API

cURL
JavaScript
PHP
Python

curl -X POST https://api.chatbotplatform.io/v1/bots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Bot",
    "description": "A helpful AI assistant"
  }'

const response = await fetch('https://api.chatbotplatform.io/v1/bots', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'My Bot',
    description: 'A helpful AI assistant'
  })
});
const data = await response.json();
console.log(data);

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_API_KEY')
    ->post('https://api.chatbotplatform.io/v1/bots', [
        'name' => 'My Bot',
        'description' => 'A helpful AI assistant'
    ]);

$bot = $response->json();

import requests

response = requests.post(
    'https://api.chatbotplatform.io/v1/bots',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'name': 'My Bot',
        'description': 'A helpful AI assistant'
    }
)
bot = response.json()
print(bot)

List all bots

cURL
JavaScript
PHP
Python

curl https://api.chatbotplatform.io/v1/bots \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.chatbotplatform.io/v1/bots', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const { data } = await response.json();
console.log(data);

$response = Http::withToken('YOUR_API_KEY')
    ->get('https://api.chatbotplatform.io/v1/bots');

$bots = $response->json('data');

response = requests.get(
    'https://api.chatbotplatform.io/v1/bots',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
bots = response.json()['data']

Update a bot

cURL
JavaScript
PHP
Python

curl -X PATCH https://api.chatbotplatform.io/v1/bots/bot_123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Bot Name",
    "description": "New description"
  }'

const response = await fetch('https://api.chatbotplatform.io/v1/bots/bot_123', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Updated Bot Name',
    description: 'New description'
  })
});

$response = Http::withToken('YOUR_API_KEY')
    ->patch('https://api.chatbotplatform.io/v1/bots/bot_123', [
        'name' => 'Updated Bot Name',
        'description' => 'New description'
    ]);

response = requests.patch(
    'https://api.chatbotplatform.io/v1/bots/bot_123',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'name': 'Updated Bot Name',
        'description': 'New description'
    }
)

Delete a bot

cURL
JavaScript
PHP
Python

curl -X DELETE https://api.chatbotplatform.io/v1/bots/bot_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

await fetch('https://api.chatbotplatform.io/v1/bots/bot_123', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

Http::withToken('YOUR_API_KEY')
    ->delete('https://api.chatbotplatform.io/v1/bots/bot_123');

requests.delete(
    'https://api.chatbotplatform.io/v1/bots/bot_123',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

Complete API Reference

View the full API specification with all endpoints, parameters, and response schemas.

Next Steps

Configure Behaviors

Customize how your bot responds

Add Integrations

Connect AI backends

Connect Channels

Deploy to messaging platforms

View Conversations

See bot conversations and history

Get Started

Agent Loops

MCP Servers

Use Cases

Bots

Overview

Creating a Bot

Bot Components

Behaviors

Typing Indicators

Should Respond Detection

Integrations

Webhook Setup

A/B Testing

Custom Headers

Channels

Telegram

Slack

Discord

Conversations

Conversation Overview

Message History

Default Integration

Multiple Channels

Bot Settings

API Access

Complete API Reference

Next Steps

Configure Behaviors

Add Integrations

Connect Channels

View Conversations

Get Started

Bots

Agent Loops

MCP Servers

Use Cases

​Overview

​Creating a Bot

​Bot Components

​Behaviors

Typing Indicators

Should Respond Detection

​Integrations

Webhook Setup

A/B Testing

Custom Headers

​Channels

Telegram

Slack

Discord

​Conversations

Conversation Overview

Message History

​Default Integration

​Multiple Channels

​Bot Settings

​API Access

Complete API Reference

​Next Steps

Configure Behaviors

Add Integrations

Connect Channels

View Conversations

Overview

Creating a Bot

Bot Components

Behaviors

Integrations

Channels

Conversations

Default Integration

Multiple Channels

Bot Settings

API Access

Next Steps