Slack 凭证#
您可以使用这些凭证来身份验证以下节点：
支持的身份验证方法#
- API 访问令牌：
- Slack Trigger 节点必需。
- 可与 Slack 节点一起使用，但不推荐。
- OAuth2：
- Slack 节点的推荐方法。
- 不适用于 Slack Trigger 节点。
相关资源#
请参考 Slack 的 API 文档 获取有关该服务的更多信息。
使用 API 访问令牌#
要配置此凭证，您需要一个 Slack 账户和：
- 一个 访问令牌
要生成访问令牌，请创建 Slack 应用：
- 打开您的 Slack API Apps 页面。
- 选择创建新应用 > 从头开始。
- 输入应用名称。
- 选择您将在其中开发应用的工作区。
- 选择创建应用。应用详情将打开。
- 在左侧菜单的功能下，选择 OAuth 和权限。
- 在作用域部分，为您的应用选择适当的作用域。请参考作用域查看推荐的作用域列表。
- 添加作用域后，转到 OAuth 令牌部分并选择安装到工作区。您必须是 Slack 工作区管理员才能完成此操作。
- 选择允许。
- 复制 Bot User OAuth Token 并在您的 n8n 凭证中将其输入为访问令牌。
- 如果您将此凭证用于 Slack Trigger，请按照 Slack Trigger 配置中的步骤完成应用设置。
更多信息请参考 Slack API 快速入门。
Slack Trigger 配置#
要将您的 Slack 应用与 Slack Trigger 节点一起使用：
- 在 Slack 中转到您的应用并选择您要使用的应用。
- 转到功能 > 事件订阅。
- 打开启用事件控制。
-
在 n8n 中，复制 Webhook URL 并在您的 Slack 应用中将其输入为请求 URL。
请求 URL
Slack 每个应用只允许一个请求 URL。如果您想测试您的工作流，您需要执行以下操作之一：
- 先使用您的测试 URL 进行测试，然后在验证一切正常工作后更改您的 Slack 应用以使用生产 URL
- 使用生产 URL 并启用执行日志。
-
验证后，选择要订阅的机器人事件。使用 n8n 中的触发条件字段来过滤这些请求。
- 要使用列表中没有的事件，请将其添加为机器人事件，并在 n8n 节点中选择任何事件。
更多信息请参考快速入门 | 配置应用以监听事件。
n8n 推荐为您的 Slack Trigger 启用请求签名验证以增加安全性：
- 在 Slack 中转到您的应用并选择您要使用的应用。
- 转到设置 > 基本信息。
- 复制签名的值。
- 在 n8n 中，将此值粘贴到凭证的签名密钥字段中。
使用 OAuth2#
n8n Cloud 用户注意事项
Cloud 用户无需提供连接详情。选择 连接我的账户 通过您的浏览器连接。
如果您正在自托管 n8n 并需要从头配置 OAuth2，您需要一个 Slack 账户和：
- 一个 客户端 ID
- 一个 客户端密钥
要获取这两者，请创建 Slack 应用：
- 打开您的 Slack API Apps 页面。
- 选择创建新应用 > 从头开始。
- 输入应用名称。
- 选择您将在其中开发应用的工作区。
- 选择创建应用。应用详情将打开。
- 在设置 > 基本信息中，打开应用凭证部分。
- 复制客户端 ID 和客户端密钥。将这些粘贴到 n8n 中的相应字段。
- 在左侧菜单的功能下，选择 OAuth 和权限。
- 在重定向 URL部分，选择添加新重定向 URL。
- 从 n8n 复制 OAuth 回调 URL 并在 Slack 中将其输入为新的重定向 URL。
- 选择添加。
- 选择保存 URL。
- 在作用域部分，为您的应用选择适当的作用域。请参考作用域查看作用域列表。
- 添加作用域后，转到 OAuth 令牌部分并选择安装到工作区。您必须是 Slack 工作区管理员才能完成此操作。
- 选择允许。
- 此时，您应该能够在 n8n 凭证中选择 OAuth 按钮进行连接。
更多信息请参考 Slack API 快速入门。有关 OAuth 流程本身的更多详情，请参考 Slack 使用 OAuth 安装文档。
作用域#
作用域决定应用具有什么权限。
- 如果您希望您的应用代表授权该应用的用户行事，请在用户令牌作用域部分下添加所需的作用域。
- 如果您正在构建机器人，请在机器人令牌作用域部分下添加所需的作用域。
以下是 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 应用。
🚀 与作者交流
📚 教程 💡 案例 🔧 技巧
⚡ 快答 🎯 定制 🚀 支持