Discord 凭据
您可以使用这些凭据来验证以下节点:
先决条件
- 创建一个Discord帐户。
- 对于 Bot 和 OAuth2 凭据:
- 设置本地开发者环境。
- 创建应用程序和机器人用户。
- 对于 Webhook 凭据,创建 Webhook。
支持的认证方式
- 机器人
- OAuth2
- 网络钩子
不确定使用哪种方法?请参阅选择身份验证方法 了解更多指导。
相关资源
请参考 Discord 的开发者文档{:target=_blank .external-link} 了解有关服务的更多信息。
使用机器人
如果您想使用机器人令牌而不是 OAuth2 将机器人添加到您的 Discord 服务器,请使用此方法。
要配置此凭据,您需要:
- A Bot Token 机器人代币:在您使用机器人创建应用程序后生成。
要创建带有机器人的应用程序并生成 Bot Token 机器人令牌:
- 如果您还没有应用程序,请在开发者门户 中创建一个应用程序。
- 输入您的应用程序的 Name 名称。
- 选择Create 创建。
- 从左侧菜单中选择 Bot 机器人。
- 在 Token 代币 下,选择 Reset Token 重置令牌 以生成新的机器人令牌。
- 复制令牌并将其添加到您的 n8n 凭证中。
- 在 Bot > Privileged Gateway Intents 机器人 > 特权网关意图 中,添加您希望机器人拥有的任何特权意图。有关特权意图的更多信息,请参阅配置您的机器人。 * n8n 建议激活 SERVER MEMBERS INTENT: Required for your bot to receive events listed under GUILD_MEMBERS 服务器成员意图:您的机器人需要接收 GUILD_MEMBERS 下列出的事件。
- 在 Installation > Installation Contexts 安装 > 安装上下文 中,选择您希望机器人使用的安装上下文: * 对于服务器安装的应用程序,请选择 Guild Install 公会安装。 (对于 n8n 用户最常见。) * 对于用户安装的应用程序,请选择 User Install 用户安装。 (对于 n8n 用户来说不太常见,但可能对测试有用。) * 请参阅 Discord 的 选择安装上下文 文档,了解有关这些安装上下文的更多信息。
- 在 Installation > Install Link 安装 > 安装链接 中,选择 Discord Provided Link Discord 提供链接(如果尚未选择)。
- 仍然在 Installation 安装 页面的 Default Install Settings 默认安装设置 部分中,选择
applications.commands和bot示波器。有关这些范围和其他范围的更多信息,请参阅 Discord 的 范围 文档。 11、添加Bot > Bot Permissions 机器人 > 机器人权限页面权限。有关更多信息,请参阅 Discord 的权限 文档。 n8n 建议为 Discord 节点选择以下权限:- 管理角色
- 管理渠道
- 阅读消息/查看频道
- 发送消息
- 创建公共线程
- 创建私有线程
- 在线程中发送消息
- 发送 TTS 消息
- 管理消息
- 管理线程
- 嵌入链接
- 附加文件
- 读取消息历史记录
- 添加反应
- 将应用程序添加到您的服务器或测试服务器:
- 转到 Installation > Install Link 安装 > 安装链接 并复制其中列出的链接。
- 将链接粘贴到浏览器中,然后按 Enter 键。
- 在安装提示中选择Add to server 添加到服务器。
- 将您的应用程序添加到服务器后,您将在成员列表中看到它。
这些步骤概述了设置 n8n 凭据所需的基本功能。请参考 Discord Creating an App{:target=_blank .external-link} 指南了解有关创建应用的更多信息,特别是:
Using OAuth2
如果您想使用 OAuth2 流程将机器人添加到 Discord 服务器,请使用此方法,这简化了安装您应用的人员的流程。
要配置此凭据,您需要:
- Client ID 客户ID
- Client Secret 客户秘密
- 选择是否在Header 标头或Body 身体中发送Authentication 认证
- Bot Token 机器人代币
有关使用机器人创建应用程序并生成令牌的详细信息,请按照上面的使用机器人中的相同步骤操作。
然后:
- 复制您生成的 Bot Token 机器人令牌 并将其添加到 n8n 凭据中。
- 在您的 Discord 应用程序中打开 OAuth2 页面以访问您的 Client ID 客户端 ID 并生成 Client Secret 客户端密钥。将这些添加到您的 n8n 凭据中。
- 从 n8n 复制 OAuth Redirect URL OAuth 重定向 URL 并将其添加到 Discord 应用程序的 OAuth2 > Redirects 中。确保您保存这些更改。
使用 webhook
要配置此凭据,您需要:
- A Webhook URL 网络钩子 URL:创建 Webhook 后生成。
要获取 Webhook URL,您需要创建一个 webhook 并复制生成的 URL:
- 打开 Discord Server Settings 服务器设置 并打开 Integrations 集成 选项卡。
- 选择 Create Webhook 创建网络钩子 创建新的 Webhook。
- 为您的 webhook 指定一个有意义的 Name 名称。
- 选择 Name 名称 旁边的 avatar 头像 来编辑或上传新头像。
- 在 CHANNEL 下拉列表中,选择 Webhook 应发布到的通道。
- 选择 Copy Webhook URL 复制 Webhook URL 以复制 Webhook URL。在您的 n8n 凭证中输入此 URL。
请参考 Discord Making a Webhook documentation{:target=_blank .external-link} 了解更多信息。
选择认证方式
最简单的安装是 webhook。您可以创建 webhook 并将其添加到 Discord 服务器上的单个频道。Webhook 可以向频道发布消息。它们不需要机器人用户或认证。但它们无法监听或响应用户请求或命令。如果您需要一种简单的方式向频道发送消息而无需交互或反馈,请使用 webhook。
机器人 是 webhook 的交互式升级。您可以将机器人添加到 Discord 服务器(在 Discord API 文档中称为 guild)或用户账户。添加到服务器的机器人可以与服务器所有频道上的用户交互。它们可以管理频道、发送和检索消息、检索所有用户列表以及更改它们的角色。如果您需要构建交互式、复杂或多步骤工作流,请使用机器人。
OAuth2 基本上是一个 bot 机器人,它使用 OAuth2 流程而不仅仅是机器人令牌。与机器人一样,您可以将它们添加到 Discord 服务器或用户帐户中。这些凭据提供与机器人相同的功能,但它们可以简化服务器上机器人的安装。