n8n 中文文档

Slack 触发节点

使用Slack触发节点响应Slack中的事件并将Slack与其他应用程序集成。 n8n 内置了对各种 Slack 事件的支持,包括新消息、反应和新通道。

在此页面上,您将找到 Slack 触发器节点可以响应的事件列表以及更多资源的链接。

提示

凭证

您可以找到该节点 Slack 凭据文档 的身份验证信息。

提示

示例和模板

有关帮助您入门的使用示例和模板,请参阅 n8n 的 Slack 集成 页面。

活动

  • 任何事件:节点在 Slack 中的任何事件上触发。
  • 应用程序主页已打开:当用户打开 Slack 应用程序的 应用程序首页 选项卡时,该节点会触发。
  • 机器人/应用程序提及:当您的机器人或应用程序在该应用程序所在的频道中为 提到的 时,该节点就会触发。
  • 文件公开:当文件为 公开 时该节点触发。
  • 文件共享:当应用程序所在频道中的文件为 共享 时,该节点会触发。
  • 新消息发布到频道:当新消息发布到应用程序所在的频道时,该节点会触发。
  • 新公共通道已创建:当创建新的 公共频道 时,节点会触发。
  • 新用户:当Slack添加新用户时,该节点触发。
  • 添加反应:当 反应 添加到应用程序添加到的消息中时,节点会触发。

参数

将事件设置为触发后,请使用其余参数进一步定义节点的行为:

  • 监视整个工作空间:节点是否应监视工作空间中所有通道中选定的事件(打开)或不监视(关闭,默认)。

    Caution

    这将为您的机器人或应用程序所在的任何渠道中的每个事件使用一次执行。请谨慎使用!

  • 观看频道:选择您的节点应观看所选事件的频道。仅当您未打开 Watch Whole Workspace 时,才会出现此参数。您可以选择一个频道:

    • 来自列表:节点使用您的凭据在工作区中查找通道列表,以便您可以选择所需的通道。
    • 按 ID:输入您要观看的频道的 ID。 Slack 在通道详情底部显示通道 ID,并带有一键复制按钮。
    • 按URL:输入您要观看的频道的URL,格式为https://app.slack.com/client/<channel-address>。
  • 下载文件:是否下载文件并在节点的输出中使用它们(打开)或不(关闭,默认)。将此参数与 文件公开 和 文件共享 事件结合使用。

选项

当您添加选项时,您可以进一步细化节点的行为:

  • 解析 ID:是否将 ID 解析为各自的名称并返回(打开)或不(关闭,默认)。
  • 要忽略的用户名或 ID:选择用户名或输入以逗号分隔的编码用户 ID 字符串以忽略其中的事件。从列表中选择,或使用 表达 指定 ID。
  • 要过滤的表情符号名称:输入以逗号分隔,不是以冒号分隔的表情符号名称列表(例如 thumbsup, eyes, white_check_mark),以将 添加反应 事件限制为仅那些特定反应。留空以触发任何反应。

相关资源

n8n 为 Slack 提供应用程序节点。您可以找到节点文档 Slack 节点文档。

在 n8n 的网站上查看 示例工作流程和相关内容。

有关 API 的详细信息,请参阅 Slack 的文档。

所需范围

要使用该节点,您需要在Slack中创建应用程序并启用事件订阅。请参阅 Slack 凭证 | Slack 触发器配置 了解更多信息。

您必须将适当的范围添加到 Slack 应用程序,此触发节点才能工作。

该节点至少需要 对话列表 和 用户列表 方法的范围。查看 范围 | Slack 凭证 列表以获取更完整的范围列表。

验证 webhook

提示

功能可用性

从 n8n 1.106.0 开始,可以使用 Slack 签名密钥验证传入的 Webhook 请求是否来自 Slack。

您可以在配置 Slack 凭证 时设置 Slack 签名秘钥。设置后,Slack 触发节点会自动验证请求是否来自 Slack 并包含可信签名。 n8n 建议设置此项以确保您仅处理从 Slack 发送的请求。

常见问题

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

工作流程仅适用于测试或生产

Slack 仅允许您为每个应用程序注册一个 Webhook。这意味着,如果不重新配置已注册的 Webhook URL,则无法从使用测试 URL 切换到使用生产 URL(反之亦然)。

如果您尝试测试也已发布的工作流程,则可能会遇到麻烦。 Slack 只会将事件发送到两个 webhook URL 之一,因此另一个永远不会收到事件通知。

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

警告

停止生产流量

这会暂时禁用您的生产工作流程进行测试。您的工作流程在未发布时将不再接收生产流量。

  1. 转到您的工作流程页面。
  2. 从工作流程设置下拉列表中,单击“取消发布”以暂时禁用工作流程。
  3. 编辑 Slack 触发配置 中的 Request URL 以使用测试 Webhook URL 而不是生产 Webhook URL。
  4. 使用测试 Webhook URL 测试您的工作流程。
  5. 完成测试后,编辑 Slack 触发配置 中的 Request URL 以使用生产 Webhook URL 而不是测试 Webhook URL。
  6. 单击“发布”以再次启用工作流程。生产 Webhook URL 应恢复工作。

令牌已过期

Slack 提供 token rotation 代币轮换,您可以为机器人和用户令牌打开它。这使得每个令牌都会在 12 小时后过期。虽然这可能对测试有用,但使用启用此功能的令牌的 n8n 凭证在过期后将失败。如果您想在生产中使用 Slack 凭证,则此功能必须是 off 关闭。

要检查您的 Slack 应用是否启用了令牌轮换,请参阅 Slack API 文档 | 令牌轮换{:target=_blank .external-link}。

提示

If your app uses token rotation 如果您的应用程序使用令牌轮换

请注意,如果您的 Slack 应用程序使用令牌轮换,您将无法再次将其关闭。您需要创建一个新的 Slack 应用程序并禁用令牌轮换。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。