Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praison.ai/llms.txt

Use this file to discover all available pages before exploring further.

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