飞书群机器人插件
1. 简介
1.1 插件简介
飞书群机器人插件:即在表单处完成相关配置,当表单数据发生变动时,借助群机器人,自动将数据推送到飞书群内。
1.2 应用场景
当表单数据有新增或变动时,可以及时推送至飞书群内,让团队成员及时关注数据变动。如:
- 销售线索推送
- 疫情防控数据预警
1.3 预期效果
2. 插件配置
本文将以「销售线索推送」为例,详细为您讲述飞书群机器人的配置以及配置后的使用效果。
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:飞书群机器人插件安装。
- 安装成功后,可前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「飞书群机器人」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 添加群机器人
登录飞书客户端,进入需要添加群机器人的群聊,点击「设置>>群机器人」。如下图所示:
在群机器人列表中选择「自定义机器人」进行添加,如下图所示:
然后依次填写机器人名称、描述后点击「添加」。如下图所示:
2.3 记录参数
在「安全设置处」开启「签名校验」,复制 wehhook 地址和签名密钥这两个参数并进行备份,后文【2.4步骤】需要使用。备份后点击「完成」,如下图所示:
2.4 配置群推送
机器人创建好以后,回到简道云进行群消息推送配置。
1)选择或新建表单
选择需要推送数据的表单,将需要推送的数据配置到插件中,或者您可以新建如下图所示的表单进行操作:
2)新建智能助手
创建以后,在「扩展功能」处,新建一个 智能助手。
3)设置触发动作
对智能助手重命名,触发动作选择「新增数据」,选择以后点击「完成」,进行下一步执行动作配置。如下图所示:
4)设置执行动作
执行动作选择【2.1步骤】中安装的「飞书群机器人」插件。然后进一步设置执行动作需要配置的具体内容,设置完毕后点击「完成」。如下图所示:
内容设置:
设置项 | 释义 | 备注 |
推送地址 | 【2.3步骤】中飞书群机器人的 webhook 地址 | |
密钥 | 【2.3步骤】中飞书群机器人的签名校验密钥 | |
消息内容 | 可以自定义编辑文本,也可以点击编辑框右侧的【+】插入表单字段 | |
消息@成员 | 可以选择简道云组织架构中的成员,必须是飞书集成模式的简道云账号设置才有效 | 即简道云中的成员与飞书中的成员相匹配,且该成员在消息推送的群内。 |
消息@所有人 | 可以选择是否@群内所有人,选择「是」后,消息推送时将@群内所有成员 |
5)保存并返回
全部设置好以后,点击「保存」并返回表单访问界面。
3. 推送效果
访问刚刚配置的表单,新建一条数据,如下图所示:
然后在飞书群内将收到一条线索推送的消息通知。如下图所示:
4. 日志查看
在「扩展功能>>智能助手」处,可以查询群消息推送的执行日志,检查消息是否推送成功。如下图所示: