Skip to content

Discord 凭证#

您可以使用这些凭证来验证以下节点：

先决条件#

支持的认证方式#

  • Bot
  • OAuth2
  • Webhook

不确定该使用哪种方法？请参考选择认证方式获取更多指导。

相关资源#

更多关于该服务的信息，请参阅 Discord 开发者文档。

使用机器人#

如果您希望通过机器人令牌而非 OAuth2 的方式将机器人添加到 Discord 服务器，请使用此方法。

配置此凭证需要：

  • 机器人令牌：创建带有机器人的应用程序后生成

创建带有机器人的应用程序并生成机器人令牌：

  1. 如果尚未创建，请在开发者门户中创建应用
  2. 输入应用名称
  3. 点击创建
  4. 在左侧菜单中选择Bot
  5. 在Token下点击Reset Token生成新的机器人令牌
  6. 复制令牌并添加到 n8n 凭证中
  7. 在Bot > Privileged Gateway Intents中添加所需的特权意图。关于特权意图的更多信息，请参考配置机器人
    • n8n 建议启用SERVER MEMBERS INTENT：机器人接收 GUILD_MEMBERS 下列出的事件所需
  8. 在Installation > Installation Contexts中选择机器人使用的安装上下文：
    • 选择Guild Install用于服务器安装应用（n8n 用户最常用）
    • 选择User Install用于用户安装应用（n8n 用户较少使用，但可能对测试有用）
    • 关于这些安装上下文的更多信息，请参考 Discord 的选择安装上下文文档
  9. 在Installation > Install Link中，如果尚未选择，请选择Discord Provided Link
  10. 仍在Installation页面，在Default Install Settings部分选择applications.commands和bot范围。关于这些及其他范围的更多信息，请参考 Discord 的范围文档
  11. 在Bot > Bot Permissions页面添加权限。更多信息请参考 Discord 的权限文档。n8n 建议为Discord节点选择以下权限：
    • 管理角色
    • 管理频道
    • 查看频道/读取消息
    • 发送消息
    • 创建公共线程
    • 创建私有线程
    • 在线程中发送消息
    • 发送TTS消息
    • 管理消息
    • 管理线程
    • 嵌入链接
    • 附加文件
    • 读取消息历史
    • 添加反应
  12. 将应用添加到服务器或测试服务器：
    1. 进入Installation > Install Link并复制列出的链接
    2. 将链接粘贴到浏览器中并按回车
    3. 在安装提示中选择添加到服务器
    4. 应用添加到服务器后，您将在成员列表中看到它

这些步骤概述了设置 n8n 凭证所需的基本功能。关于创建应用的更多信息，特别是以下内容，请参考 Discord 的创建应用指南：

使用 OAuth2 认证#

如果您希望通过 OAuth2 流程将机器人添加到 Discord 服务器（这可以简化用户安装应用的过程），请使用此方法。

配置此凭据需要准备以下信息：

  • 客户端 ID
  • 客户端密钥
  • 选择将认证信息发送至请求头还是请求体
  • 机器人令牌

关于如何创建带机器人的应用程序并生成令牌的详细步骤，请参考上文使用机器人部分的相同流程。

具体操作步骤：

  1. 复制生成的机器人令牌并添加到 n8n 凭据中。
  2. 在 Discord 应用中打开 OAuth2 页面获取客户端 ID并生成客户端密钥，将这些信息添加到 n8n 凭据。
  3. 从 n8n 复制 OAuth 重定向 URL，将其添加到 Discord 应用的 OAuth2 > 重定向设置中。请确保保存这些更改。

使用 Webhook#

配置此凭据需要准备：

  • Webhook URL：创建 webhook 时生成的地址

获取 Webhook URL 的步骤：

  1. 打开 Discord 的服务器设置，进入集成选项卡。
  2. 选择创建 Webhook来新建一个 webhook。
  3. 为 webhook 设置一个有意义的名称。
  4. 点击名称旁边的头像可编辑或上传新头像。
  5. 在频道下拉菜单中选择 webhook 要发布消息的频道。
  6. 选择复制 Webhook URL复制该地址，将其粘贴到 n8n 凭据中。

更多信息请参阅 Discord 官方 Webhook 指南。

选择认证方式#

最简单的安装方式是使用 webhook。您可以在 Discord 服务器的单个频道上创建并添加 webhook。Webhook 能够向频道发布消息，不需要机器人用户或身份验证。但它们无法监听或响应用户请求或命令。如果您只需要一种简单的方式来向频道发送消息，而不需要交互或反馈，请使用 webhook。

机器人是比 webhook 更高级的交互方式。您可以将机器人添加到 Discord 服务器（在 Discord API 文档中称为 guild）或用户账户。添加到服务器的机器人可以与所有频道中的用户互动，管理频道、发送和检索消息、获取所有用户列表以及更改他们的角色。如果您需要构建交互式、复杂或多步骤的工作流，请使用机器人。

OAuth2 本质上是一个使用 OAuth2 流程而非仅使用机器人令牌的 机器人。与机器人一样，您可以将它们添加到 Discord 服务器或用户账户。这些凭证提供与机器人相同的功能，但可以简化机器人在您服务器上的安装过程。