Skip to main content
Connects via the Discord Gateway v10 WebSocket.

Prerequisites

  1. A Discord application and bot token from the Discord Developer Portal
  2. MESSAGE CONTENT privileged intent enabled in the portal
  3. The bot invited to your server with Send Messages, Read Message History, and View Channels permissions

Invite URL

Replace CLIENT_ID with your application’s client ID:
https://discord.com/api/oauth2/authorize?client_id=CLIENT_ID&scope=bot&permissions=68608

Configuration

In ~/.meepagateway/agents/<id>/agent.yaml:
connectors:
  - type: discord
    bot_token: "your-discord-bot-token"
    guild_ids: []  # empty = all guilds; set to ["guild_id"] to restrict
bot_token
string
required
Discord bot token from the Developer Portal.
guild_ids
array
default:"[]"
Restrict the bot to specific guilds (servers). Empty means all guilds.Example: ["1234567890123456789"]

Behavior

  • Self-messages are filtered automatically (bot user ID from the READY event)
  • Long responses are chunked at Discord’s 2000-character limit
  • Rate limit headers are respected with automatic retry (max 2 retries)
  • Guild and channel metadata is tracked from GUILD_CREATE events
The MESSAGE CONTENT privileged intent must be enabled in the Discord Developer Portal. Without it, the bot connects but receives empty message content.