Connect Discord to your agents for interacting with servers, channels, and messages.

Discord Integration

Discord provides access to servers (guilds), channels, and messages. Your agents can read message history, post messages, and browse server information.

OAuth Setup

When you click Connect Discord on the dashboard, Supyagent requests the following scopes:

Scope	Access
`identify`	Read your Discord user information
`guilds`	View servers you are a member of
`bot`	Bot access for reading/sending messages in channels

Permissions

Permission ID	Name	Type	Description
`discord.guilds.read`	Read servers	read	View servers you are a member of
`discord.channels.read`	Read channels	read	View channels in servers
`discord.messages.read`	Read messages	read	View message history in channels
`discord.messages.write`	Send messages	write	Send messages to channels

Servers (Guilds)

Example Actions

List servers:

curl -X GET "https://app.supyagent.com/api/v1/discord/guilds" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

List servers the bot has been added to
View server details (name, member count, icon)

Channels

Example Actions

List channels in a server:

curl -X GET "https://app.supyagent.com/api/v1/discord/guilds/{guildId}/channels" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

List text, voice, and category channels
View channel details (name, topic, type)

Messages

Example Actions

Read recent messages:

curl -X GET "https://app.supyagent.com/api/v1/discord/channels/{channelId}/messages?limit=20" \
  -H "Authorization: Bearer sk_live_..."

Send a message:

curl -X POST "https://app.supyagent.com/api/v1/discord/channels/{channelId}/messages" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Build #247 passed all tests. Ready for deployment."
  }'

What Agents Can Do

Read message history in text channels
Send messages to any channel the bot has access to
View message metadata (author, timestamp, reactions)

Setup Notes

Discord integration requires adding the Supyagent bot to your Discord server:

Connect Discord on the Supyagent dashboard
Authorize the bot with the requested permissions
The bot will appear in your server's member list
Ensure the bot has access to the channels you want your agents to interact with

Bot Permissions

The bot needs the following Discord permissions in each channel:

Read Messages / View Channels -- for reading message history
Send Messages -- for posting messages
Read Message History -- for accessing older messages

Notes

Discord uses snowflake IDs for guilds, channels, and messages -- these are numeric strings
The bot can only access channels it has been granted permission to view
Rate limits: Discord allows 5 requests per second per route
Message content requires the Message Content privileged intent for bots in 100+ servers

Discord

On this page