N8N中文教程
集成节点/Built in_nodes/Triggers

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 中的一个发送事件,因此另一个将永远不会收到事件通知。

要解决此问题,您可以在测试时禁用工作流:

停止生产流量 这会暂时禁用生产工作流以进行测试。工作流在停用期间将不再接收生产流量。

  1. 转到您的工作流页面
  2. 在顶部面板切换 Active 开关,暂时禁用工作流
  3. 在 Slack 触发器配置中编辑 Request URL,使用测试 webhook URL 替代生产 webhook URL
  4. 使用测试 webhook URL 测试工作流
  5. 测试完成后,在 Slack 触发器配置中编辑 Request URL,使用生产 webhook URL 替代测试 webhook URL
  6. 切换 Inactive 开关重新启用工作流。生产 webhook URL 应恢复正常工作

Token expired#

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

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

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

文档反馈 本页面 !点赞有帮助 !点踩无帮助 感谢您的反馈! 提交 上一页 Shopify Trigger 下一页 Strava Trigger 基于 Material for MkDocs Insiders 构建