Skip to main content

Overview

Discord tool allows you to send messages via webhooks or bot tokens to Discord servers.

Installation

pip install "praisonai[tools]"

Environment Variables

export DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
export DISCORD_BOT_TOKEN=your_bot_token  # Optional

Quick Start

from praisonai_tools import DiscordTool

# Initialize with webhook
discord = DiscordTool(webhook_url="https://discord.com/api/webhooks/...")

# Send message
discord.send_webhook("Hello from PraisonAI!")

Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import DiscordTool

agent = Agent(
    name="DiscordBot",
    instructions="You send notifications to Discord.",
    tools=[DiscordTool()]
)

response = agent.chat("Send an alert to Discord about the new release")
print(response)

Available Methods

send_webhook(content, username=None)

Send a message via webhook.
from praisonai_tools import DiscordTool

discord = DiscordTool()
discord.send_webhook("Alert: System is down!", username="AlertBot")

send_message(channel_id, content)

Send a message to a channel (requires bot token).
discord.send_message("123456789", "Hello!")

Common Errors

ErrorCauseSolution
DISCORD_WEBHOOK_URL not configuredMissing webhookSet environment variable
Invalid webhookWrong URLCheck webhook URL
Rate limitedToo many messagesAdd delays