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

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

智能伙伴Aily手册精选NaN-NaN-NaN
产品功能
功能介绍
当期望飞书消息的特定事件(如接收用户在群发的消息、消息已读等)变更时,通过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. 检查下推送的用户是否应用可用范围中?如果推送对象用户不在应用可用范围中,将收不到机器人推送的消息
将对应用户加到应用可用范围中
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

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