Skip to content

Discord 凭据#

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

前提条件#

支持的认证方法#

  • Bot 机器人
  • OAuth2
  • Webhook

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

相关资源#

请参考 Discord 的开发者文档 了解有关服务的更多信息。

使用机器人#

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

要配置此凭据，您需要：

  • 一个 Bot Token 机器人令牌：创建带有机器人的应用程序后生成。

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

  1. 如果您还没有，请在 developer portal 中创建一个应用。
  2. 为您的应用输入一个 Name。
  3. 选择 Create。
  4. 从左侧菜单选择 Bot。
  5. 在 Token 下，选择 Reset Token 以生成新的机器人令牌。
  6. 复制令牌并将其添加到您的 n8n 凭据中。
  7. 在 Bot > Privileged Gateway Intents 中，添加您希望机器人拥有的任何特权意图。请参考 Configuring your bot 了解有关特权意图的更多信息。
    • n8n 建议激活 SERVER MEMBERS INTENT: Required for your bot to receive events listed under GUILD_MEMBERS。
  8. 在 Installation > Installation Contexts 中，选择您希望机器人使用的安装上下文：
    • 选择 Guild Install 用于服务器安装的应用（n8n 用户最常见）。
    • 选择 User Install 用于用户安装的应用（n8n 用户较少见，但可能对测试有用）。
    • 请参考 Discord 的 Choosing installation contexts 文档了解有关这些安装上下文的更多信息。
  9. 在 Installation > Install Link 中，如果尚未选择，请选择 Discord Provided Link。
  10. 仍在 Installation 页面，在 Default Install Settings 部分，选择 applications.commands 和 bot 作用域。请参考 Discord 的 Scopes 文档了解有关这些和其他作用域的更多信息。
  11. 在 Bot > Bot Permissions 页面添加权限。请参考 Discord 的 Permissions 文档了解更多信息。n8n 建议为 Discord 节点选择以下权限：
    • Manage Roles
    • Manage Channels
    • Read Messages/View Channels
    • Send Messages
    • Create Public Threads
    • Create Private Threads
    • Send Messages in Threads
    • Send TTS Messages
    • Manage Messages
    • Manage Threads
    • Embed Links
    • Attach Files
    • Read Message History
    • Add Reactions
  12. 将应用添加到您的服务器或测试服务器：
    1. 转到 Installation > Install Link 并复制那里列出的链接。
    2. 将链接粘贴到您的浏览器中并按 Enter。
    3. 在安装提示中选择 Add to server。
    4. 将您的应用添加到服务器后，您将在成员列表中看到它。

这些步骤概述了设置 n8n 凭据所需的基本功能。请参考 Discord Creating an App 指南了解有关创建应用的更多信息，特别是：

使用 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#

要配置此凭据，您需要：

  • 一个 Webhook 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。在您的 n8n 凭据中输入此 URL。

请参考 Discord Making a Webhook documentation 了解更多信息。

选择认证方法#

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

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

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