Skip to content

Slack Trigger 节点#

使用 Slack Trigger 节点可以响应 Slack 中的事件，并将 Slack 与其他应用程序集成。n8n 内置支持多种 Slack 事件，包括新消息、反应表情和新频道等。

本页面列出了 Slack Trigger 节点能够响应的事件列表，并提供相关资源链接。

凭据

您可以在此处找到该节点的认证信息。

示例和模板

如需使用示例和模板快速入门，请参考 n8n 的 Slack 集成页面。

事件类型#

  • 任意事件：节点会触发 Slack 中的任何事件。
  • 机器人/应用提及：当您的机器人或应用在已加入的频道中被提及时触发。
  • 文件设为公开：当文件被设为公开时触发。
  • 文件分享：当文件在应用已加入的频道中被分享时触发。
  • 频道新消息：当应用已加入的频道中发布新消息时触发。
  • 新建公开频道：当新建公开频道时触发。
  • 新用户：当有新用户加入 Slack 时触发。
  • 添加反应表情：当在应用已加入的消息上添加反应表情时触发。

参数#

设置好触发事件后，使用以下参数进一步定义节点的行为：

  • 监控整个工作区：是否监控工作区中所有频道内发生的选定事件（开启）或不监控（关闭，默认值）。

    注意

    这将为您的机器人或应用所在任何频道中的每个事件消耗一次执行次数。请谨慎使用！

  • 监控频道：选择节点应监控的频道以侦测选定事件。仅当未开启监控整个工作区时显示此参数。您可以通过以下方式选择频道：

    • 从列表选择：节点会使用您的凭证查询工作区中的频道列表，以便您选择目标频道。
    • 通过ID指定：输入要监控的频道ID。Slack会在频道详情底部显示频道ID并提供一键复制按钮。
    • 通过URL指定：输入要监控的频道URL，格式为https://app.slack.com/client/<channel-address>。
  • 下载文件：是否下载文件并在节点输出中使用（开启）或不下载（关闭，默认值）。此参数需配合文件公开和文件共享事件使用。

选项#

通过添加选项可进一步微调节点行为：

  • 解析ID：是否将ID解析为对应的名称并返回（开启）或不解析（关闭，默认值）。
  • 忽略的用户名或ID：选择用户名或输入逗号分隔的编码用户ID字符串以忽略来自这些用户的事件。可从列表中选择，或使用表达式指定ID。

相关资源#

n8n 提供了 Slack 的应用节点。您可以在此处找到节点文档。

在 n8n 官网上查看示例工作流及相关内容。

有关 Slack API 的详细信息，请参阅 Slack 官方文档。

所需权限范围#

要使用此节点，您需要在 Slack 中创建一个应用并启用事件订阅。更多信息请参阅 Slack 凭据 | Slack 触发器配置。

您必须为 Slack 应用添加适当的权限范围才能使此触发器节点正常工作。

该节点至少需要 conversations.list 和 users.list 方法的权限范围。查看权限范围 | Slack 凭据列表获取更完整的权限范围清单。

常见问题#

以下是 Slack 触发器节点的一些常见错误和问题，以及解决或排查步骤。

工作流仅在测试或生产环境中有效#

Slack 限制每个应用只能注册一个 webhook。这意味着您无法在不重新配置已注册 webhook URL 的情况下，从测试 URL 切换到生产 URL（反之亦然）。

如果您尝试测试一个同时在生产环境中运行的工作流，可能会遇到问题。Slack 只会向两个 webhook URL 中的一个发送事件，因此另一个 URL 将永远不会收到事件通知。

解决方法是在测试时禁用工作流：

暂停生产流量

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

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

令牌过期#

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

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

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

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