Slack Trigger 节点#
使用 Slack Trigger 节点可响应 Slack 中的事件,并将 Slack 与其他应用程序集成。n8n 内置支持多种 Slack 事件,包括新消息、回应表情和新频道。
本页面将列出 Slack Trigger 节点能够响应的事件列表及相关资源链接。
凭证配置
您可以在此处查看该节点的认证信息。
使用案例与模板
如需查看入门指导的使用示例和模板,请参考 n8n 的 Slack 集成页面。
事件类型#
- 任意事件:节点在 Slack 中发生任何事件时触发
- 机器人/应用提及:当您的机器人或应用在所在频道中被提及时触发
- 文件公开:当文件被设置为公开状态时触发
- 文件共享:当文件在应用所在频道中被共享时触发
- 频道新消息:当应用所在频道发布新消息时触发
- 新建公开频道:当创建新的公开频道时触发
- 新用户:当有新用户加入 Slack 时触发
- 添加回应:当应用所在消息被添加表情回应时触发
参数#
设置触发事件后,使用以下参数进一步定义节点的行为:
- 监控整个工作区:是否在 workspace 的所有频道中监控所选事件(开启)或仅监控指定频道(关闭,默认值)。 注意 这将消耗执行次数:您的机器人或应用所在任意频道中的每个事件都会触发一次执行。请谨慎使用!
- 监控频道:选择节点需要监控的频道以监听所选事件。仅当未开启监控整个工作区时显示此参数。您可以通过以下方式选择频道:
- 从列表选择:节点使用您的凭据获取工作区中的频道列表,以便选择目标频道
- 通过 ID 指定:输入要监控的频道 ID。Slack 在频道详情底部显示频道 ID 并提供一键复制按钮
- 通过 URL 指定:输入要监控的频道 URL,格式为
https://app.slack.com/client/<channel-address>
- 下载文件:是否下载文件并在节点输出中使用(开启)或忽略文件(关闭,默认值)。此参数需与文件公开和文件共享事件配合使用
选项#
通过添加选项可进一步微调节点行为:
- 解析 ID:是否将 ID 解析为对应名称并返回(开启)或保持原始 ID(关闭,默认值)
- 忽略的用户名或 ID:选择用户名或输入逗号分隔的编码用户 ID 字符串以忽略来自这些用户的事件。可从列表选择,或使用表达式指定 ID
相关资源#
n8n 为 Slack 提供了应用节点。您可以在此处查看节点文档。 在 n8n 官网上查看示例工作流及相关内容。 有关 Slack API 的详细信息,请参阅Slack 官方文档。
所需权限范围#
使用此节点需要在 Slack 中创建应用程序并启用事件订阅。更多信息请参阅 Slack 凭据 | Slack 触发器配置。
必须为 Slack 应用添加适当的权限范围,此触发器节点才能正常工作。 该节点至少需要 conversations.list 和 users.list 方法的权限范围。查看权限范围 | Slack 凭据列表获取更完整的权限范围清单。
验证 Webhook#
从版本 1.106.0 开始,您可以在配置 Slack 凭据时设置 Slack 签名密钥。设置后,Slack 触发器节点会自动验证请求是否来自 Slack 并包含可信签名。n8n 建议设置此选项以确保仅处理来自 Slack 的请求。
常见问题#
以下是 Slack 触发器节点的一些常见错误和问题,以及解决或故障排除的步骤。
工作流仅在测试或生产环境中生效#
Slack 只允许每个应用注册单个 webhook。这意味着不重新配置已注册的 webhook URL,就无法从测试 URL 切换到生产 URL(反之亦然)。
如果您尝试测试一个在生产环境中同时处于活跃状态的工作流,可能会遇到此问题。Slack 只会向两个 webhook URL 中的一个发送事件,因此另一个将永远不会收到事件通知。
要解决此问题,您可以在测试时禁用工作流:
停止生产流量 这会暂时禁用生产工作流以进行测试。工作流在停用期间将不再接收生产流量。
- 转到您的工作流页面
- 在顶部面板切换 Active 开关,暂时禁用工作流
- 在 Slack 触发器配置中编辑 Request URL,使用测试 webhook URL 替代生产 webhook URL
- 使用测试 webhook URL 测试工作流
- 测试完成后,在 Slack 触发器配置中编辑 Request URL,使用生产 webhook URL 替代测试 webhook URL
- 切换 Inactive 开关重新启用工作流。生产 webhook URL 应恢复正常工作
Token expired#
Slack 提供可针对机器人和用户令牌开启的令牌轮换功能。这将使所有令牌在 12 小时后失效。虽然此功能在测试时可能有用,但使用启用了此功能的令牌的 n8n 凭证将在过期后失效。如果您需要在生产环境中使用 Slack 凭证,必须关闭此功能。
要检查您的 Slack 应用是否开启了令牌轮换功能,请参阅 Slack API 文档 | 令牌轮换。
如果您的应用使用令牌轮换 请注意:如果您的 Slack 应用已启用令牌轮换,将无法再次关闭该功能。您需要创建一个新的 Slack 应用并禁用令牌轮换功能。
文档反馈 本页面 !点赞有帮助 !点踩无帮助 感谢您的反馈! 提交 上一页 Shopify Trigger 下一页 Strava Trigger 基于 Material for MkDocs Insiders 构建