# Discord Bot AI integration on Definable

> Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions

## What this connects

Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions

Vendor: https://discord.com/

## Tools available

**165** tools available. First 12:

- `DISCORDBOT_ADD_GROUP_DM_USER` — Add recipient to group channel — Adds a user to a Discord group Direct Message (DM) channel. IMPORTANT: This action requires a user OAuth2 access token with the 'gdm.join' scope in the access_token parameter. Bot tokens cannot be used for this endpoint as bots cannot join or manage group DMs per Discord's API limitations. The user being added must also have authorized your application with the gdm.join scope. Note: This endpoint was designed for the deprecated GameBridge SDK and may have limited functionality.
- `DISCORDBOT_ADD_GUILD_MEMBER` — Add guild member — Adds a user (who is not already a member) to a guild using their `access_token` (which must have `guilds.join` scope), optionally setting nickname, roles, mute/deaf status, or flags.
- `DISCORDBOT_ADD_GUILD_MEMBER_ROLE` — Assign role to guild member — Assigns a role to a guild member, provided the bot has 'Manage Roles' permission in the guild and the role to be assigned is hierarchically lower than the bot's highest role.
- `DISCORDBOT_ADD_MY_MESSAGE_REACTION` — Add reaction to message — Adds an emoji reaction (Unicode or custom) from the authenticated bot to a specific message in a Discord channel. Returns 204 No Content on success. Requires READ_MESSAGE_HISTORY permission, and ADD_REACTIONS permission if no one else has reacted with this emoji yet. Supports both Unicode emojis (e.g., 👍) and custom server emojis using 'name:id' format.
- `DISCORDBOT_ADD_THREAD_MEMBER` — Add thread member — Adds a user to a specific, unarchived thread; the user must have access to the thread's parent channel, and for private threads, the bot must already be a member.
- `DISCORDBOT_BAN_USER_FROM_GUILD` — Ban user from guild — Permanently bans a user from a Discord guild, optionally deleting their recent messages (specify deletion period in seconds OR days, not both).
- `DISCORDBOT_BULK_BAN_USERS_FROM_GUILD` — Bulk ban users in guild with message deletion option — Bans up to 200 users from a Discord guild, optionally deleting their recent messages; the bot must have 'Ban Members' permission in the guild, and this action is irreversible.
- `DISCORDBOT_BULK_DELETE_MESSAGES` — Bulk delete messages in channel — Atomically bulk deletes messages in a Discord channel for moderation or maintenance; deletion may not be instantaneous and messages are unrecoverable.
- `DISCORDBOT_CREATE_APPLICATION_COMMAND` — Create application command objects — Creates a new global Discord application command, accessible across guilds and in DMs (if `dm_permission` is true), noting global commands can take up to an hour to propagate and have registration limits; for guild-specific commands, use a different action.
- `DISCORDBOT_CREATE_AUTO_MODERATION_RULE` — Create guild auto moderation rule — Creates a new auto moderation rule for a Discord guild to automatically moderate content. Requires 'MANAGE_GUILD' permission. Use this to set up filters for profanity, spam, excessive mentions, or custom keywords. Each rule has a trigger type (what to look for), trigger metadata (specific configuration), and actions (what to do when triggered).
- `DISCORDBOT_CREATE_CHANNEL_INVITE` — Create Channel Invite — Creates a new invite link for the specified Discord channel. The bot must have 'CREATE_INSTANT_INVITE' permission for that channel. Optionally configure the invite's expiration time, usage limit, and other properties. Returns the invite code and details including a shareable invite URL (format: https://discord.gg/{code}).
- `DISCORDBOT_CREATE_DM` — Initiate user channel with recipient — Creates a new direct message (DM) channel or retrieves an existing one, using `recipient_id` for a 1-on-1 DM or `access_tokens` for a group DM; this action only establishes or fetches the channel and does not send messages.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Discord Bot

Inside a Definable workflow, Discord Bot is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Discord Bot** — the Researcher (GPT-5.5) pulls context from Discord Bot (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Discord Bot** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Discord Bot (create record, post message, draft email).
- **Designer / Engineer → Distributor → Discord Bot** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Discord Bot (attach file, open PR comment, post status).

The Verifier checks every Discord Bot call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- team chat — https://definable.ai/apps/category/team-chat/
- team collaboration — https://definable.ai/apps/category/team-collaboration/

## Related

- HTML page: https://definable.ai/apps/discordbot/
- Same category (team chat): https://definable.ai/apps/category/team-chat/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt