Slack 凭证#

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

• Slack
• Slack触发器

支持的认证方法#

• API access token:
  • Slack Trigger 节点所必需的。
  • 可与Slack节点配合使用，但不推荐。
• OAuth2:
  • Slack节点的推荐方法。
  • 无法与Slack Trigger节点配合使用。

相关资源#

更多关于该服务的信息，请参考Slack的API文档。

使用API访问令牌#

要配置此凭证，您需要一个Slack账户以及：

• 一个访问令牌

要生成访问令牌，请创建一个Slack应用：

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

更多信息请参考Slack API的快速入门。

Slack触发器配置#

要在Slack Trigger节点中使用您的Slack应用：

1. 前往功能 > 事件订阅。
2. 开启启用事件控制选项。

3. 在n8n中，复制Webhook URL并将其作为Request URL输入到您的Slack应用中。

   请求URL

   Slack 每个应用仅允许一个请求URL。如需测试工作流，您需要执行以下操作之一：

   • 首先使用测试URL进行测试，待确认一切运行正常后，再将Slack应用切换至生产环境URL
   • 使用生产环境URL并启用执行日志记录。

4. 验证通过后，选择要订阅的机器人事件。在n8n中使用触发条件字段来筛选这些请求。

   • 要使用列表中未列出的事件，请将其添加为机器人事件，并在n8n节点中选择任意事件。

更多信息请参考快速入门 | 配置应用程序进行事件监听。

使用OAuth2认证#

如果您正在自托管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，并将其作为新的重定向URL输入到Slack中。
11. 选择添加。
12. 选择保存URL。
13. 在作用域部分，为您的应用选择适当的作用域。有关作用域列表，请参阅作用域。
14. 添加权限范围后，转到OAuth令牌部分并选择安装到工作区。您必须是Slack工作区管理员才能完成此操作。
15. 选择允许。
16. 此时，您应该能够在n8n凭证中选择OAuth按钮进行连接。

更多信息请参考Slack API的快速入门。关于OAuth流程本身的更多详情，请参阅Slack的使用OAuth安装文档。

作用域#

作用域决定应用拥有哪些权限。

• 如果您希望应用代表授权用户执行操作，请在用户令牌作用域部分添加所需的作用域。
• 如果您正在构建一个机器人，请在Bot Token Scopes部分添加所需的作用域。

以下是OAuth凭证所需的作用域列表，这是一个很好的起点：

常见问题#

令牌已过期#

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

要检查您的Slack应用是否启用了令牌轮换功能，请参阅Slack API文档 | 令牌轮换。