Bots - PraisonAI

Agents can live inside Slack — chat naturally where your team works.

Quick Start

Simple Usage

import { Agent, createSlackBot } from 'praisonai';

const agent = new Agent({
  instructions: 'You are a helpful team assistant'
});

const bot = createSlackBot({
  botToken: process.env.SLACK_BOT_TOKEN!,
  appToken: process.env.SLACK_APP_TOKEN!,
  socketMode: true
});

bot.onMessage(async (message) => {
  const response = await agent.chat(message.text);
  return { text: response, threadTs: message.ts };
});

await bot.start();
// ⚡️ Slack bot is running in Socket Mode

With Configuration

bot.onAppMention(async (message) => {
  const response = await agent.chat(message.text);
  return { text: response, threadTs: message.ts };
});

User Interaction Flow

Configuration

import { createSlackBot } from 'praisonai';

// Webhook mode (production)
const bot = createSlackBot({
  botToken: process.env.SLACK_BOT_TOKEN!,
  signingSecret: process.env.SLACK_SIGNING_SECRET!
});

bot.onMessage(async (message) => {
  return { text: 'Hello!' };
});

await bot.listen(3000); // Start webhook server

// Socket Mode (development — no public URL needed)
const devBot = createSlackBot({
  botToken: process.env.SLACK_BOT_TOKEN!,
  appToken: process.env.SLACK_APP_TOKEN!,
  socketMode: true
});

devBot.onMessage(async (message) => {
  return { text: 'Hello!' };
});

await devBot.start();

Option	Type	Required	Description
`botToken`	`string`	✅	Bot OAuth token (`xoxb-...`)
`appToken`	`string`	Socket Mode	App-level token (`xapp-...`)
`signingSecret`	`string`	Webhook	For webhook request verification
`socketMode`	`boolean`	—	Enable Socket Mode (default: `false`)

Send Messages Proactively

// Send a message to any channel
await bot.sendMessage('#general', 'Daily standup reminder!', {
  threadTs: '1234567890.123456'  // optional: reply in thread
});

Other Platforms

The TypeScript SDK currently supports Slack via createSlackBot. Support for Telegram, Discord, and WhatsApp is coming soon.For multi-platform bots today, use the Python SDK which supports all four platforms.

Environment Variables

Variable	Description
`SLACK_BOT_TOKEN`	Bot OAuth token
`SLACK_APP_TOKEN`	App-level token for Socket Mode
`SLACK_SIGNING_SECRET`	For webhook mode verification

Best Practices

Use Socket Mode for development

No public URL needed — easier for local testing.

Reply in threads

Keep conversations organized by setting threadTs in responses.

Handle errors gracefully

Always return a response, even if just “I couldn’t process that”.

Agent

Create agents

Python Messaging Bots

Multi-platform bot support (Telegram, Discord, Slack, WhatsApp)

​Quick Start

​User Interaction Flow

​Configuration

​Send Messages Proactively

​Other Platforms

​Environment Variables

​Best Practices

​Related

Agent

Python Messaging Bots

Quick Start

User Interaction Flow

Configuration

Send Messages Proactively

Other Platforms

Environment Variables

Best Practices

Related