Bots

Connect agents to Slack and other platforms

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

Quick Start

1. 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

2. 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();

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

Environment Variables

Best Practices

Related