消息与机器人 / Discord Developer Platform

Discord 开发者平台

Discord 支持应用命令、交互组件、机器人、频道 Webhook、用户 OAuth 授权及应用收费功能。个人开发者可从自己的账号和测试服务器开始，但安装范围、服务器权限、特权意图和商业化资格需要分别配置。

机器人应用命令Webhook社区工具OAuth订阅

01 / CAPABILITIES

开放功能

核心接口调用手册

3 个场景

覆盖频道 Webhook、机器人消息读写、斜杠命令注册与签名回调 3 个场景；示例使用 API v10，不自动化普通用户账号。

使用 Webhook 向频道发通知机器人发送并读取频道消息注册测试命令并处理签名回调

应用命令与交互

在用户账号或服务器中提供斜杠命令及应用交互，构建查询、游戏或业务工具入口。

接入要求配置安装上下文与 applications.commands 等 scopes；User Install 以命令响应为主，Guild Install 可进一步配置 Bot 权限。

注册测试命令并处理签名回调站内调用手册 · 参数、代码与排错

Building your first Discord Bot：安装、权限与测试

频道通知与 Webhook

通过 Incoming Webhook 向指定频道发布外部系统通知；也可按相应能力配置应用事件回调。

接入要求Incoming Webhook 无需创建机器人用户，但 Webhook Token 仍是凭证；发消息不等于获得读取频道历史的权限。

使用 Webhook 向频道发通知站内调用手册 · 参数、代码与排错

Webhook Resource：频道投递与应用事件

机器人与事件监听

机器人可连接 Gateway 接收获授权的消息、成员或状态事件，并按服务器权限执行相应操作。

接入要求服务器安装权限与 Gateway Intents 分开配置；消息内容、成员与在线状态等特权数据需要相应开关及适用审核。

机器人发送并读取频道消息站内调用手册 · 参数、代码与排错

Gateway：事件、特权意图与当前审核规则 OAuth2：用户授权与 Bot 用户限制 Building your first Discord Bot：安装、权限与测试

用户授权与账号资料

让用户通过 OAuth2 授权基本身份及受支持的数据范围，用于网站登录或账号关联。

接入要求按功能申请 identify 等具体 scopes；OAuth 用户授权与机器人的 Bot Token 权限不同，不能自动化普通用户账号代替机器人。

OAuth2：用户授权与 Bot 用户限制

应用订阅与一次性购买

符合条件的应用可通过 Premium Apps 管理商品、订阅与购买权益，提供收费功能。

接入要求需要团队持有已验证应用，满足负责人年龄、2FA、条款、隐私政策及受支持地区的收款审核；此项不是普通创建应用的默认能力。

应用商业化：订阅、SKU 与权益 Enabling Monetization：团队、验证和地区条件

02 / REQUIREMENTS

接入条件

适用主体: 独立开发者、社区工具开发者、服务器管理者、互动应用团队
接入方式: 机器人使用 Bot Token 调用支持的 API / 用户身份和安装使用相应 OAuth2 scopes / Incoming Webhook 使用生成的 Webhook URL 与 Token / HTTP 应用交互需按官方流程验证请求签名
申请概况: 个人可创建应用；服务器安装、特权数据和应用收费各需授权或审核。

拥有符合平台规则的 Discord 账号，在 Developer Portal 创建应用并保管凭证。
按实际场景选择 User Install 或 Guild Install；服务器安装需要安装者具备相应权限。
按需开启 Intents；当前 Gateway 文档按跨服务器可见的唯一用户规模规定特权意图审核，获准后还可能需要年度复审。
遵守开发者政策，数据访问限于应用声明功能；提供问题反馈渠道并保护用户数据。

Building your first Discord Bot：安装、权限与测试 Gateway：事件、特权意图与当前审核规则 Discord Developer Policy：数据与应用行为

03 / GET STARTED

开通步骤

01
创建应用与测试位置
在开发者后台创建应用；使用自己的账号和不影响真实用户的服务器进行开发。
02
配置安装与权限
选择用户或服务器安装，设置必要 scopes、机器人权限和事件 Intents。
03
接收命令或事件
选择适合的 HTTP 交互、Gateway 或 Webhook 方式，按官方示例处理签名、连接和响应。
04
再评估分发与收费
扩大使用前核对验证和特权意图审核；需要收费功能时单独检查团队与地区资格。

04 / COSTS & LIMITS

费用、边界与测试方式

费用概况

区分 API 接入、自行托管和应用内销售三类成本。

本次基础接入文档未列通用按次调用价，因此不标注所有产品永久免费；机器人程序、HTTP 回调或 Gateway 服务的托管由开发者自行安排。
Premium Apps 的收费单位是订阅或一次性购买 SKU；用户购买后，应用依据 Entitlements 判断权益，不按普通消息条数收费。
Monetization Terms 规定每笔购买可扣支付处理费、交易费和 Discord 平台分成，计算方式受产品、渠道与适用档位影响；这不是 API 请求单价。
提现、税费、退款和拒付还适用独立规则；先确认商业化与收款资格，再决定是否接入收费能力。

Building your first Discord Bot：安装、权限与测试应用商业化：订阅、SKU 与权益 Enabling Monetization：团队、验证和地区条件 Monetization Terms：费用、分成和结算

使用范围与限制

Webhook、Bot Token、OAuth scopes、服务器权限和 Gateway Intents 解决不同问题，不能相互代替。
普通用户账号不能作为 self-bot 任意自动化；机器人不能像普通用户一样拥有好友或加入群组私信。
特权意图不等于可任意收集社区数据；当前政策禁止抓取、出售 API 数据及未经明确许可使用消息训练模型。
触发限流时应依据响应头与 retry_after 等信息退避；接口和 Gateway 还存在各自限制。
应用审核、特权意图审核与 Premium Apps 商业化审核是不同流程。当前收费功能指引仅列美国、欧盟和英国的支持流程，不能据此承诺全球可收款。

如何进行开发测试

官方建议在自己的用户账号和不活跃的测试服务器中开发。
测试应用、服务器及频道仍属于 Discord 平台，发消息和权限修改会产生实际效果。
本次未确认覆盖所有功能的统一隔离沙箱，商业化测试应另外阅读相应 Entitlement 与测试工具说明。

接入前再确认

扩大分发前，分别核对应用验证与特权意图审核要求，不能用其中一项替代另一项。
Premium Apps 是否可用取决于团队、应用及收款地区资格。
未完成任何用户账号、服务器安装、特权意图或实际收款验证。

05 / OFFICIAL SOURCES

官方资料

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

01
Building your first Discord Bot：安装、权限与测试已核对官方资料 · 2026-10-15
02
Gateway：事件、特权意图与当前审核规则已核对官方资料 · 2026-10-15
03
OAuth2：用户授权与 Bot 用户限制已核对官方资料 · 2026-10-15
04
Webhook Resource：频道投递与应用事件已核对官方资料 · 2026-10-15
05
API Rate Limits已核对官方资料 · 2026-10-15
06
Discord Developer Policy：数据与应用行为已核对官方资料 · 2026-10-15
07
应用商业化：订阅、SKU 与权益已核对官方资料 · 2026-10-15
08
Enabling Monetization：团队、验证和地区条件已核对官方资料 · 2026-10-15
09
Monetization Terms：费用、分成和结算已核对官方资料 · 2026-10-15
10
Developer Portal，未登录核验账号官方入口 · 细则待复核 · 2026-10-15

官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明