飞书智能伙伴Aily之飞书消息触发器 - 飞书官网
产品功能

飞书智能伙伴Aily之飞书消息触发器

飞书

2024-12-23

功能介绍​
配置步骤​
测试任务​
提交启用​
常见问题​
功能介绍 ​
当期望飞书消息的特定事件(如接收用户在群发的消息、消息已读等)变更时,通过AI准确、高效传递信息,提效各类工作场景(比如当用户在群内发送消息时,将消息记录在多维表格中;当检测到消息存在违规字段时,撤回消息等)。可在任务中配置 「飞书消息」 触发方式,以达到预期效果。 ​
常见的飞书群组触发器使用场景和实践: ​
  • 群消息 AI 分析:用户通过飞书群组来实现群信息同步和收集,比如话题群收集用户反馈场景。但是,群组中的问题跟进和内容沉淀往往只能靠人工提取和录入,既耗时费力,又容易出现各类错误。通过接收「接收用户在群组的消息」触发器事件实现:群消息 AI 抓取同步到多维表格 - > AI 智能分类提取内容 - > 定时推送洞察内容 - > 群内容实时查询的链路。本方案已提供开箱即用的接入:群消息 AI 分析方案,10分钟可快速在 Aily 平台搭建完成。 ​
配置步骤 ​
(一)添加触发器 ​
进入任务编辑页面,触发方式选择「 飞书消息」: ​
​
250px|700px|reset
​
​
(二)配置触发事件 ​
触发事件是指可以触发当前流程的具体事件,目前「飞书消息」支持的触发事件如下图所示: ​
​
​
250px|700px|reset
​
​
​
250px|700px|reset
​
​
​
触发事件 ​
事件说名 ​
需申请的飞书权限 ​
更详细的事件业务说明 ​
  • 接收用户在群组的消息 ​
用户在机器人所在群中发送消息(不包含机器人发送的消息)时,触发此事件 ​
获取群组中所有消息 ​
  • 消息已读 ​
用户阅读机器人发送的单聊消息时,触发此事件 ​
获取单聊、群组消息 ​
  • 消息撤回 ​
机器人所在会话内的消息被撤回时,触发此事件 ​
获取单聊、群组消息 ​
  • 用户修改是否接收机器人消息配置 ​
用户开启或关闭机器人的“接收消息推送”设置时,触发该事件。 ​
根据该事件在飞书开放平台的可见性,该事件仅部分租户可见 ​
获取单聊、群组消息 ​
  • 新增消息表情回复 ​
消息被添加表情回复时会触发此事件 ​
获取单聊、群组消息 ​
  • 删除消息表情回复 ​
消息的表情回复取消时,触发此事件 ​
获取单聊、群组消息 ​
​
(三)触发条件 ​
设置特定的触发条件,可以实现:事件发生并且满足所设置的条件时才触发。 ​
触发条件非必选属性,如无需求,可跳过。 ​
​
250px|700px|reset
​
​
当无需配置触发条件时,默认监听到即触发 ​
​
250px|700px|reset
​
​
(四)输出数据 ​
在选择了触发事件后,会根据所选的触发事件显示接收到的事件内容,接收到的事件内容也是当前触发节点的「输出变量」。 ​
​
250px|700px|reset
​
​
以「接收用户在群组的消息」触发器为例 ​
展示了事件发生后,在后续的技能配置中,我们可以引用这具体字段作为变量入参 ​
测试任务 ​
配置完成后,可点击「测试」进行任务的运行效果测试。 ​
在测试面板中,支持通过模拟数据(mock)触发 ​
  • 根据触发器要求,自动生成模拟数据 ​
  • 模拟数据支持修改 ​
点击底部“执行测试”按钮,即可使用该模拟数据进行测试去执行开发环境的技能,触发后执行技能的结果可以在「调试和预览」中查看。 ​
​
250px|700px|reset
​
​
提交启用 ​
任务测试完之后,效果符合预期。可点击「提交」,启用当前任务。 ​
​
250px|700px|reset
​
​
发布 ​
任务提交后,需要发布应用。发布成功后,修改后的任务才可以正常生效。 ​
如果这个触发事件涉及到应用的飞书权限、飞书事件有变化,则需要提交飞书应用发布申请,申请成功到该权限和事件后,相应的飞书事件才可以正常监听,任务才可以正常触发。 ​
首次发布应用时,在发布应用时会一并把权限和事件一起申请和发布 ​
二次发布应用时,当检测到有新增的权限、事件时,有「小i」提示,可点击后弹窗中申请对应飞书权限和事件。 ​
​
250px|700px|reset
​
​
​
250px|700px|reset
​
​
常见问题 ​
  1. 测试任务时,在线上和测试企业做相应的飞书消息事件后,比如「接收用户在群组的消息」,并没有在「调试和预览」中触发? ​
在测试任务时,任务的触发器数据为模拟数据(mock),所有需要在模拟数据中进行修改来模拟触发,触发后将测执行开发环境的技能,执行技能的结果可以在「调试和预览」中查看 ​
  • 如技能有消息推送配置,将推送消息到「调试预览」框中 ​
  • 如技能中没有消息推送配置,将可在「调试预览」框中查看技能日志,看技能执行是否符合预期 ​
  1. 为什么线上相应的事件触发了,预期应该执行技能,但最终没有执行技能? ​
一般来说,有以下几种情况,请按顺序逐个检查: ​
​
问题情况 ​
解决方法 ​
  1. 检查下新增/修改后的任务是否有发布?未发布的话,任务还未生效,自然不会执行 ​
发布任务 ​
  1. 检查下任务是否有对应的飞书权限、事件尚未申请?未申请的话,将无法监听到对应的事件触发 ​
将对应的飞书权限、事件进行发布申请 ​
  1. 检查下是否配置了触发条件?只有满足触发条件的事件才会触发并执行任务 ​
因为没有满足触发条件,所有没有执行技能。可根据情况修改触发条件。 ​
  1. 检查下机器人是否在群中?往群推送消息时,需要需要保障机器人在所在群中,才能监听到相应事件 ​
将机器人拉进对应的群 ​
  1. 检查下推送的用户是否应用可用范围中?如果推送对象用户不在应用可用范围中,将收不到机器人推送的消息 ​
将对应用户加到应用可用范围中 ​
​
​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题

字节跳动旗下 AI 工作平台

联系我们立即试用