Discord

Send messages and interact with Discord servers

Overview

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

The user asks to post or read messages; the agent calls Discord and returns the outcome.

Diagram

Installation

bash

pip install "praisonai[tools]"

Environment Variables

bash

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

Quick Start

Simple Usage

python

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!")

With Configuration
Use the same tool with an agent — see Usage with Agent below, or pass env vars and options from the sections above.

Usage with Agent

python

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.

python

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

python

discord.send_message("123456789", "Hello!")

Common Errors

Error	Cause	Solution
`DISCORD_WEBHOOK_URL not configured`	Missing webhook	Set environment variable
`Invalid webhook`	Wrong URL	Check webhook URL
`Rate limited`	Too many messages	Add delays