Discord 凭证#
您可以使用这些凭证来验证以下节点:
先决条件#
支持的认证方法#
- 机器人
- OAuth2
- Webhook
不确定使用哪种方法?请参考选择认证方法获取更多指导。
相关资源#
有关该服务的更多信息,请参考Discord开发者文档。
使用机器人#
如果想使用机器人令牌而非OAuth2将机器人添加到Discord服务器,请使用此方法。
要配置此凭证,您需要:
- 一个机器人令牌:在创建带有机器人的应用程序时生成。
要创建一个带有机器人的应用程序并生成机器人令牌:
- 如果您还没有,请在开发者门户中创建一个应用。
- 为您的应用输入一个名称。
- 选择创建。
- 从左侧菜单中选择Bot。
- 在Token下,选择重置Token以生成新的机器人令牌。
- 复制令牌并将其添加到您的n8n凭证中。
- In Bot > Privileged Gateway Intents, add any privileged intents you want your bot to have. Refer to 配置你的机器人 for more information on privileged intents.
- n8n 建议启用 服务器成员意图:这是让您的机器人接收 GUILD_MEMBERS 下列出的事件所必需的。
- In Installation > Installation Contexts, select the installation contexts you want your bot to use:
- 选择Guild Install用于服务器安装的应用。(n8n用户最常用的方式)
- 选择用户安装用于用户安装的应用程序。(对于n8n用户不太常见,但可能对测试有用。)
- 有关这些安装上下文的更多信息,请参考Discord的选择安装上下文文档。
- 在安装 > 安装链接中,如果尚未选择,请选择Discord提供的链接。
- 仍在安装页面中,在默认安装设置部分,选择
applications.commands和bot范围。有关这些范围及其他范围的更多信息,请参阅Discord的Scopes文档。 - Add permissions on the Bot > Bot Permissions page. Refer to Discord's 权限 documentation for more information. n8n recommends selecting these permissions for the Discord node:
- 管理角色
- 管理频道
- 读取消息/查看频道
- 发送消息
- 创建公共线程
- 创建私有线程
- 在线程中发送消息
- 发送TTS消息
- 管理消息
- 管理线程
- 嵌入链接
- 附加文件
- 读取消息历史记录
- 添加反应
- Add the app to your server or test server:
- 前往安装 > 安装链接并复制那里列出的链接。
- 将链接粘贴到浏览器中并按Enter键。
- 在安装提示中选择添加到服务器。
- 将您的应用添加到服务器后,您将在成员列表中看到它。
以下步骤概述了设置n8n凭据所需的基本功能。有关创建应用程序的更多信息,特别是:请参考Discord创建应用指南
- 获取您的凭据 将您的应用凭据导入本地开发环境。
- Handling interactivity 了解如何为交互式
/slash命令设置公共端点。
使用OAuth2认证#
如果你想通过OAuth2流程将机器人添加到Discord服务器,请使用此方法,这将简化安装你应用程序的过程。
要配置此凭证,您需要:
- 一个客户端ID
- 一个客户端密钥
- 选择是否在请求头或请求体中发送认证信息
- 一个机器人令牌
有关创建带有机器人的应用程序及生成令牌的详细信息,请按照上文使用机器人中的相同步骤操作。
然后:
- 复制您生成的机器人令牌并将其添加到n8n凭证中。
- 打开Discord应用中的OAuth2页面,获取您的客户端ID并生成客户端密钥。将这些信息添加到您的n8n凭证中。
- 从n8n复制OAuth重定向URL,并将其添加到Discord应用的OAuth2 > 重定向部分。请确保保存这些更改。
使用webhook#
要配置此凭证,您需要:
- 一个Webhook URL:创建webhook时自动生成。
要获取Webhook URL,您需要创建一个webhook并复制生成的URL:
- 打开您的Discord 服务器设置并进入集成选项卡。
- 选择创建Webhook以创建新的webhook。
- 为你的webhook设置一个名称,使其含义明确。
- 选择名称旁边的头像来编辑或上传新头像。
- 在CHANNEL下拉菜单中,选择webhook应该发布到的频道。
- 选择复制Webhook URL以复制Webhook URL。将此URL输入到您的n8n凭证中。
更多信息请参考Discord创建Webhook文档。
选择认证方式#
最简单的安装方式是使用webhook。您可以在Discord服务器的单个频道上创建并添加webhook。Webhook能够向频道发送消息,不需要机器人用户或身份验证。但它们无法监听或响应用户请求或命令。如果您只需要一种简单的方式来向频道发送消息,而不需要交互或反馈,请使用webhook。
一个机器人是比webhook更高级的交互式工具。您可以将机器人添加到Discord服务器(在Discord API文档中称为guild)或用户账户。添加到服务器的机器人可以与所有服务器频道上的用户互动。它们可以管理频道、发送和检索消息、获取所有用户列表以及更改用户角色。如果您需要构建交互式、复杂或多步骤的工作流程,请使用机器人。
OAuth2本质上是一个机器人,它使用OAuth2流程而不仅仅是机器人令牌。与普通机器人一样,您可以将这些凭证添加到Discord服务器或用户账户中。这些凭证提供与机器人相同的功能,但可以简化机器人在您服务器上的安装过程。