n8n 中文文档

Discord 凭据

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

先决条件

支持的认证方式

  • 机器人
  • OAuth2
  • 网络钩子

不确定使用哪种方法?请参阅选择身份验证方法 了解更多指导。

相关资源

请参考 Discord 的开发者文档{:target=_blank .external-link} 了解有关服务的更多信息。

使用机器人

如果您想使用机器人令牌而不是 OAuth2 将机器人添加到您的 Discord 服务器,请使用此方法。

要配置此凭据,您需要:

  • A Bot Token 机器人代币:在您使用机器人创建应用程序后生成。

要创建带有机器人的应用程序并生成 Bot Token 机器人令牌:

  1. 如果您还没有应用程序,请在开发者门户 中创建一个应用程序。
  2. 输入您的应用程序的 Name 名称。
  3. 选择Create 创建。
  4. 从左侧菜单中选择 Bot 机器人。
  5. 在 Token 代币 下,选择 Reset Token 重置令牌 以生成新的机器人令牌。
  6. 复制令牌并将其添加到您的 n8n 凭证中。
  7. 在 Bot > Privileged Gateway Intents 机器人 > 特权网关意图 中,添加您希望机器人拥有的任何特权意图。有关特权意图的更多信息,请参阅配置您的机器人。 * n8n 建议激活 SERVER MEMBERS INTENT: Required for your bot to receive events listed under GUILD_MEMBERS 服务器成员意图:您的机器人需要接收 GUILD_MEMBERS 下列出的事件。
  8. 在 Installation > Installation Contexts 安装 > 安装上下文 中,选择您希望机器人使用的安装上下文: * 对于服务器安装的应用程序,请选择 Guild Install 公会安装。 (对于 n8n 用户最常见。) * 对于用户安装的应用程序,请选择 User Install 用户安装。 (对于 n8n 用户来说不太常见,但可能对测试有用。) * 请参阅 Discord 的 选择安装上下文 文档,了解有关这些安装上下文的更多信息。
  9. 在 Installation > Install Link 安装 > 安装链接 中,选择 Discord Provided Link Discord 提供链接(如果尚未选择)。
  10. 仍然在 Installation 安装 页面的 Default Install Settings 默认安装设置 部分中,选择 applications.commands 和 bot 示波器。有关这些范围和其他范围的更多信息,请参阅 Discord 的 范围 文档。 11、添加Bot > Bot Permissions 机器人 > 机器人权限页面权限。有关更多信息,请参阅 Discord 的权限 文档。 n8n 建议为 Discord 节点选择以下权限:
    • 管理角色
    • 管理渠道
    • 阅读消息/查看频道
    • 发送消息
    • 创建公共线程
    • 创建私有线程
    • 在线程中发送消息
    • 发送 TTS 消息
    • 管理消息
    • 管理线程
    • 嵌入链接
    • 附加文件
    • 读取消息历史记录
    • 添加反应
  11. 将应用程序添加到您的服务器或测试服务器:
    1. 转到 Installation > Install Link 安装 > 安装链接 并复制其中列出的链接。
    2. 将链接粘贴到浏览器中,然后按 Enter 键。
    3. 在安装提示中选择Add to server 添加到服务器。
    4. 将您的应用程序添加到服务器后,您将在成员列表中看到它。

这些步骤概述了设置 n8n 凭据所需的基本功能。请参考 Discord Creating an App{:target=_blank .external-link} 指南了解有关创建应用的更多信息,特别是:

  • 获取您的凭据 用于将应用程序的凭据获取到本地开发人员环境中。
  • 处理交互性 有关为交互式 /slash 命令设置公共端点的信息。

Using OAuth2

如果您想使用 OAuth2 流程将机器人添加到 Discord 服务器,请使用此方法,这简化了安装您应用的人员的流程。

要配置此凭据,您需要:

  • Client ID 客户ID
  • Client Secret 客户秘密
  • 选择是否在Header 标头或Body 身体中发送Authentication 认证
  • Bot Token 机器人代币

有关使用机器人创建应用程序并生成令牌的详细信息,请按照上面的使用机器人中的相同步骤操作。

然后:

  1. 复制您生成的 Bot Token 机器人令牌 并将其添加到 n8n 凭据中。
  2. 在您的 Discord 应用程序中打开 OAuth2 页面以访问您的 Client ID 客户端 ID 并生成 Client Secret 客户端密钥。将这些添加到您的 n8n 凭据中。
  3. 从 n8n 复制 OAuth Redirect URL OAuth 重定向 URL 并将其添加到 Discord 应用程序的 OAuth2 > Redirects 中。确保您保存这些更改。

使用 webhook

要配置此凭据,您需要:

  • A Webhook URL 网络钩子 URL:创建 Webhook 后生成。

要获取 Webhook URL,您需要创建一个 webhook 并复制生成的 URL:

  1. 打开 Discord Server Settings 服务器设置 并打开 Integrations 集成 选项卡。
  2. 选择 Create Webhook 创建网络钩子 创建新的 Webhook。
  3. 为您的 webhook 指定一个有意义的 Name 名称。
  4. 选择 Name 名称 旁边的 avatar 头像 来编辑或上传新头像。
  5. 在 CHANNEL 下拉列表中,选择 Webhook 应发布到的通道。
  6. 选择 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 服务器或用户帐户中。这些凭据提供与机器人相同的功能,但它们可以简化服务器上​​机器人的安装。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。