Skip to content
Build Perch
Browse documentation

Discord

Short answer: Discord support is a bot you create in Discord’s developer portal and invite to your own server. Build Perch talks to it over Discord’s official Bot REST API. Once connected, the AI can read channel messages and post text, replies, rich embed cards, and file or audio attachments, always asking first before anything sends.

How does the Discord integration work?

Build Perch calls Discord’s official Bot API directly from your machine. Your bot token is stored securely, like every other integration secret: once saved, it can never be read back. The bot only sees the servers you invite it into, never your personal DMs or your account’s other servers.

How do I connect a bot?

  1. Create a Discord application and bot at discord.com/developers.
  2. Under Bot, enable the Message Content Intent: Discord withholds message text from bots by default, and the read tools need it.
  3. Copy the bot token.
  4. In Build Perch, open Integrations → Discord, paste the token, and click Save & connect; it’s validated immediately and shows the bot’s username on success.
  5. Invite the bot to a server using the developer portal’s OAuth2 URL Generator (scope: bot).
  6. Add the Discord skill to a mode so the AI can use it.

What can the AI send?

  • Browse: discord_list_guilds and discord_list_channels show which servers and text channels the bot can reach.
  • Read: discord_read_messages returns recent messages: id, author, text, and any attachments.
  • Post: discord_send_message can send plain text, a reply to a specific message, up to 10 rich embed cards (title, description, color, up to 25 fields, footer, author; text only, no images or links), and/or up to 10 file or audio attachments pulled from the workspace. Every send stops at an approval banner first, and outgoing messages never ping @everyone, roles, or individual users.
  • Download: discord_get_attachment saves a message’s attachment into the workspace.

Good to know

  • The message-content intent is not optional. Skip it and discord_read_messages comes back with metadata but no message text.
  • Sending can’t skip approval, even on “approve everything”: discord_send_message is flagged as an external send.
  • Audio and file uploads arrive as regular attachments with an inline player, not Discord’s native waveform voice-note format.
  • Live voice-channel streaming isn’t supported: the integration is REST-only, with no persistent voice connection.