Discord Integration

Connect Discord to your agents for messaging, events, and bot interactions.

Overview

The Discord integration lets your agents send messages, respond to events, and interact with Discord servers through your own bot.

Why "Bring Your Own Key" (BYOK)?

By creating your own Discord application and bot, you get complete control over which servers receive your bot and what events it can respond to.

Benefits:

• Your own bot — customize the name, avatar, and permissions
• Isolated events — only receive events from servers where your bot is invited
• Full control — configure exactly which intents and events to use
• Webhook verification — secure interactions with your public key

Prerequisites

Before connecting, you'll need:

1. A Discord account
2. A Discord server where you have admin permissions (to invite your bot)

Step 1: Create a Discord Application

1. Go to the Discord Developer Portal
2. Click New Application
3. Name your application (e.g., "Inference Agent")
4. Agree to the Terms of Service
5. Click Create

Step 2: Create a Bot

1. In your application, go to the Bot section
2. Click Add Bot
3. Customize your bot:
   • Username — the name shown in servers
   • Icon — your bot's avatar
4. Under Privileged Gateway Intents, enable what you need:

1. Copy the Token — you'll need this

Important: Never share your bot token. If compromised, regenerate it immediately.

Step 3: Configure OAuth2

1. Go to the OAuth2 section
2. Copy the Client ID and Client Secret
3. Add a redirect URL:

1. Under OAuth2 URL Generator, select scopes:
   • identify — access user info
   • email — access user email
   • guilds — see user's servers
   • bot — add bot to servers

Step 4: Get Your Credentials

From your Discord application, collect:

Step 5: Connect in inference.sh

Configure credentials

1. Go to Settings → Secrets → Integrations
2. Find Discord and click Configure
3. Enter your credentials:
   • Application ID (Client ID)
   • Client Secret
   • Bot Token
   • Public Key (for webhook verification)
4. Click Save credentials

These are stored securely as encrypted secrets.

Authorize the connection

1. Click Connect
2. You'll be redirected to Discord to authorize
3. Select which server to add the bot to
4. Review bot permissions
5. Click Authorize
6. Done! Your Discord integration is now active.

Inviting Your Bot to Servers

To use your bot in a server, it needs to be invited with the right permissions:

1. Go to OAuth2 → URL Generator in the Developer Portal
2. Select scopes: bot, applications.commands
3. Select bot permissions based on your needs:

1. Copy the generated URL and open it
2. Select a server and authorize

Agent chat and event triggers

Agent messaging channel webhooks (per-agent chat endpoints like Slack's) are not available for Discord yet. Only Slack is registered for POST /agents/{id}/channel/{provider} today. See Slack integration for the supported setup.

Discord event triggers (for example discord.message.created, discord.member.joined) are available after you connect via OAuth. Subscribe to them on an agent in the workspace — no global webhook URL is required.

Do not point Discord's Interactions Endpoint URL at https://api.inference.sh/webhooks/discord — that path is not implemented. Slash commands and button interactions must be hosted on your own infrastructure for now.

Capabilities

Using in apps

Declare Discord requirements in your app:

1integrations:2  - key: discord.bot3    description: Send messages to Discord45  - key: discord.guilds6    description: List available servers7    optional: true

At runtime, your app receives:

1DISCORD_ACCESS_TOKEN=oauth2-user-token2DISCORD_BOT_TOKEN=bot-token3DISCORD_USER_ID=123456789

Example: Send a message

1import discord2import os34client = discord.Client(intents=discord.Intents.default())56@client.event7async def on_ready():8    channel = client.get_channel(CHANNEL_ID)9    await channel.send("Hello from my AI agent! 🤖")10    await client.close()1112client.run(os.environ["DISCORD_BOT_TOKEN"])

Example: Using webhooks (simpler)

1import requests2import os34webhook_url = "https://discord.com/api/webhooks/..."56requests.post(webhook_url, json={7    "content": "Hello from my AI agent! 🤖"8})

Example: REST API

1import requests2import os34headers = {5    "Authorization": f"Bot {os.environ['DISCORD_BOT_TOKEN']}"6}78# Send a message9response = requests.post(10    f"https://discord.com/api/v10/channels/{channel_id}/messages",11    headers=headers,12    json={"content": "Hello!"}13)

Gateway Events (Real-time)

For real-time events, your bot connects to Discord's Gateway:

Note: Gateway connections require a persistent process. For simpler use cases, consider using webhooks or the REST API.

Security

• Your bot — you control the application and its permissions
• Public key verification — interactions are cryptographically verified
• Bot token — keep this secret; regenerate if compromised
• Permission scopes — bots only get permissions you explicitly grant

Revoking access

1. From inference.sh: Settings → Integrations → Disconnect
2. From Discord: Server Settings → Integrations → Remove bot
3. Regenerate token: Developer Portal → Bot → Reset Token

Troubleshooting

"Invalid token"

• Verify your bot token is correct
• Check if the token was regenerated
• Ensure no extra spaces in the token

"Missing permissions"

• The bot needs specific permissions for each action
• Re-invite the bot with the required permissions
• Check Server Settings → Roles for the bot's role

"Missing access"

• Your bot isn't in the server, or lacks channel access
• Invite the bot or check channel permissions

"Interaction failed"

• Verify your Public Key in inference.sh matches Discord
• Check that the Interactions Endpoint URL is correct

"Message content intent required"

• Enable Message Content Intent in Bot settings
• This is required to read message text

Rate Limits

Discord has rate limits to prevent abuse:

The Discord libraries handle rate limiting automatically.

Next

→ Back to Integrations Overview