Skip to main content

Overview

Slack tool allows you to send messages, read channels, and interact with Slack workspaces.

Installation

pip install "praisonai[tools]"

Environment Variables

export SLACK_BOT_TOKEN=xoxb-your-bot-token
export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...  # Optional

Quick Start

from praisonai_tools import SlackTool

# Initialize
slack = SlackTool()

# Send message
slack.send_message("#general", "Hello from PraisonAI!")

Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import SlackTool

agent = Agent(
    name="SlackBot",
    instructions="You send notifications to Slack.",
    tools=[SlackTool()]
)

response = agent.chat("Send a message to #alerts saying the deployment is complete")
print(response)

Available Methods

send_message(channel, text)

Send a message to a channel.
from praisonai_tools import SlackTool

slack = SlackTool()
slack.send_message("#general", "Hello!")

get_channels()

List available channels.
channels = slack.get_channels()

get_history(channel, limit=10)

Get channel message history.
messages = slack.get_history("#general", limit=20)

Common Errors

ErrorCauseSolution
SLACK_BOT_TOKEN not configuredMissing tokenSet environment variable
channel_not_foundInvalid channelCheck channel name
not_in_channelBot not in channelInvite bot to channel