Skip to main content

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

​
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

1

Simple Usage

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

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

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

​
How It Works

​
Best Practices

Read the Discord token from the environment, never hard-code it in the tool.
Grant the bot only the channels and permissions it needs for the task.
Discord returns HTTP 429 under load. Retry with backoff so the agent stays responsive.

Slack

Slack messaging

Telegram

Telegram bot

Email

Email notifications