Skip to content

Slack 凭证

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

支持的身份验证方法

有关该服务的更多信息,请参阅Slack 的 API 文档

使用 API 访问令牌

要配置此凭证,您需要一个Slack帐户和:

  • 访问令牌

要生成访问令牌,请创建一个 Slack 应用程序:

  1. 打开您的Slack API 应用程序页面。
  2. 选择创建新应用程序 > 从头开始
  3. 输入应用程序名称
  4. 选择您将在其中开发应用程序的工作区
  5. 选择​ 创建应用。 此时将打开应用详细信息。
  6. 在左侧菜单中的功能下,选择OAuth 和权限
  7. “范围”部分中,为您的应用选择合适的范围。请参阅“范围”部分,查看推荐范围的列表。
  8. 添加范围后,转到“OAuth 令牌”部分,然后选择“安装到工作区” 。 您必须是 Slack 工作区管理员才能完成此操作。
  9. 选择“允许”
  10. 复制Bot User OAuth Token并将其作为访问令牌输入到您的 n8n 凭证中。
  11. 如果您将此凭证用于Slack Trigger ,请按照Slack Trigger 配置中的步骤完成应用程序的设置。

有关更多信息,请参阅 Slack API快速入门

Slack Trigger 配置

要将 Slack 应用程序与Slack Trigger节点一起使用:

  1. 转到“功能” > “事件订阅”
  2. 打开启用事件控件。
  3. 首先使用
    • 测试 URL
    • 进行测试
    ,然后在
    • 验证一切正常后将
    • 您的 Slack 应用程序更改为使用
    • 生产 URL
    • 使用
    带有执行日志记录的
    • 生产 URL
    • 要使用列表中不存在的事件,请将其添加为机器人事件,然后
    • 在 n8n 节点中
    选择
    • 任何事件

请参阅快速入门 | 配置应用程序以监听事件以获取更多信息。

使用 OAuth2

n8n Cloud 用户须知

云用户无需提供连接详细信息。选择“连接我的帐户”即可通过浏览器进行连接。

如果您是自托管 n8n并且需要从头开始配置 OAuth2,那么您将需要一个Slack帐户和:

  • 客户端ID
  • 客户秘密

要同时获得这两者,请创建一个 Slack 应用程序:

  1. 打开您的Slack API 应用程序页面。
  2. 选择创建新应用程序 > 从头开始
  3. 输入应用程序名称
  4. 选择您将在其中开发应用程序的工作区
  5. 选择​ 创建应用。 此时将打开应用详细信息。
  6. “设置”>“基本信息”中,打开“应用程序凭据”部分。
  7. 复制客户端 ID客户端密钥。将它们粘贴到 n8n 中的相应字段中。
  8. 在左侧菜单中的功能下,选择OAuth 和权限
  9. “重定向 URL”部分中,选择“添加新重定向 URL”
  10. 从 n8n复制OAuth 回调 URL并将其作为 Slack 中的新重定向 URL 输入。
  11. 选择“添加”
  12. 选择保存 URL
  13. “范围”部分中,为您的应用选择合适的范围。请参阅“范围”以获取范围列表。
  14. 添加范围后,转到“OAuth 令牌”部分,然后选择“安装到工作区” 。 您必须是 Slack 工作区管理员才能完成此操作。
  15. 选择“允许”
  16. 此时,您应该能够选择 n8n 凭证中的 OAuth 按钮进行连接。

请参阅 Slack API快速入门了解更多信息。有关 OAuth 流程本身的更多详细信息,请参阅使用 OAuth 安装Slack 文档。

作用域

范围决定应用程序具有哪些权限。

  • 如果您希望您的应用代表授权该应用的用户行事,请在“用户令牌范围”部分下添加所需的范围。
  • 如果您正在构建机器人,请在“机器人令牌范围”部分下添加所需的范围。

以下是 OAuth 凭证所需范围的列表,这是一个很好的起点:

范围名称 笔记
channels:read
channels:write 不可用作机器人令牌范围
chat:write
files:read
files:write
groups:read
im:read
mpim:read
reactions:read
reactions:write
stars:read 不可用作机器人令牌范围
stars:write 不可用作机器人令牌范围
usergroups:read
usergroups:write
users.profile:read
users.profile:write 不可用作机器人令牌范围
users:read

常见问题

令牌已过期

Slack 提供令牌轮换功能,您可以为机器人和用户令牌启用此功能。这将使所有令牌在 12 小时后过期。虽然此功能可能在测试中有用,但使用启用此功能的令牌的 n8n 凭证在过期后将失效。如果您想在生产环境中使用 Slack 凭证,则必须关闭此功能。

要检查您的 Slack 应用是否已启用令牌轮换,请参阅Slack API 文档 | 令牌轮换

如果您的应用使用令牌轮换

请注意,如果您的 Slack 应用启用了令牌轮换功能,您将无法再次关闭它。您需要创建一个新的 Slack 应用并禁用令牌轮换功能。