Slack 触发器节点#
使用Slack触发器节点来响应Slack中的事件,并将Slack与其他应用程序集成。n8n内置支持多种Slack事件,包括新消息、反应和新频道。
本页面列出了Slack触发器节点能够响应的事件列表,并提供了更多资源的链接。
Credentials
您可以在此节点的此处找到认证信息。
示例和模板
如需使用示例和模板帮助您快速上手,请参阅n8n的Slack集成页面。
事件#
- 任意事件: 该节点会在Slack中任何事件发生时触发。
- 机器人/应用提及: 当您的机器人或应用在所在频道中被提及时,该节点会触发。
- 文件公开: 当文件被设为公开时,该节点会触发。
- 文件共享: 当应用所在频道中有文件被共享时,该节点会触发。
- 新消息发布到频道: 当有新消息发布到应用所在的频道时,该节点会触发。
- 新建公共频道: 当创建新的公共频道时触发该节点。
- 新用户: 当有新用户被添加到Slack时,该节点会触发。
- 新增反应: 当反应被添加到应用所在的消息时,该节点会触发。
参数#
设置好触发事件后,使用剩余参数进一步定义节点的行为:
-
监控整个工作区: 节点是否应监控工作区中所有通道的选定事件(开启)或不监控(关闭,默认)。
注意
这将为您的机器人或应用所在的每个通道中的每个事件使用一次执行。请谨慎使用!
-
监控频道: 选择您的节点需要监控指定事件的频道。此参数仅在您未启用监控整个工作区时显示。您可以选择一个频道:
- 从列表选择: 该节点会使用您的凭证查询工作区中的频道列表,以便您选择目标频道。
- 按ID: 输入您想监控的频道ID。Slack会在频道详情底部显示频道ID,并带有一键复制按钮。
- 通过URL: 输入您想查看的频道URL,格式为
https://app.slack.com/client/。
- 下载文件: 是否下载文件并在节点输出中使用它们(开启)或不使用(关闭,默认)。将此参数与文件公开和文件共享事件一起使用。
选项#
当您添加选项时,可以进一步优化节点的行为:
- 解析ID: 是否将ID解析为对应的名称并返回(开启)或不解析(关闭,默认)。
- 要忽略的用户名或ID: 选择用户名或输入逗号分隔的编码用户ID字符串以忽略来自这些用户的事件。从列表中选择,或使用表达式指定ID。
相关资源#
n8n提供了一个用于Slack的应用节点。您可以在此处here找到节点文档。
查看n8n网站上的示例工作流和相关内容。
详情请参阅Slack的文档了解其API相关信息。
所需权限范围#
要使用此节点,您需要在Slack中创建一个应用程序并启用事件订阅。更多信息请参考Slack credentials | Slack Trigger configuration。
您必须为Slack应用添加适当的作用域,此触发节点才能正常工作。
该节点至少需要conversations.list和users.list方法的权限范围。查看Scopes | Slack credentials列表获取更完整的权限范围列表。
常见问题#
以下是Slack触发器节点常见错误和问题及其解决或排查步骤。
工作流仅在测试或生产环境中有效#
Slack仅允许每个应用注册一个webhook。这意味着如果不重新配置已注册的webhook URL,您无法从测试URL切换到生产URL(反之亦然)。
如果您尝试测试一个在生产环境中也处于活动状态的工作流,可能会遇到这个问题。Slack只会将事件发送到两个webhook URL中的一个,因此另一个将永远不会收到事件通知。
为了解决这个问题,你可以在测试时禁用你的工作流:
暂停生产流量
这会暂时停用您的生产工作流以进行测试。工作流停用期间将不再接收生产流量。
- 转到您的工作流页面。
- 点击顶部面板中的启用开关可临时停用该工作流。
- 在您的Slack触发器配置中编辑请求URL,使用测试webhook URL替代生产环境webhook URL。
- 使用测试webhook URL测试您的工作流。
- 完成测试后,在Slack触发器配置中编辑请求URL,将测试用的webhook URL替换为生产环境webhook URL。
- 切换Inactive开关以重新启用工作流。生产环境webhook URL应会恢复工作。
令牌已过期#
Slack提供令牌轮换功能,您可以为机器人和用户令牌启用此功能。这将使所有令牌在12小时后失效。虽然这对测试可能有用,但使用启用了此功能的令牌的n8n凭证将在过期后失效。如果您想在正式环境中使用Slack凭证,必须关闭此功能。
要检查您的Slack应用是否启用了令牌轮换功能,请参阅Slack API文档 | 令牌轮换。
如果你的应用使用了令牌轮换
请注意,如果您的Slack应用启用了令牌轮换功能,将无法再次关闭该功能。您需要创建一个新的Slack应用,并在创建时禁用令牌轮换功能。