飞书群机器人插件
1. 简介
1.1 插件简介
飞书群机器人插件:即在表单处完成相关配置,当表单数据发生变动时,借助群机器人,自动将数据推送到飞书群内。
1.2 应用场景
当表单数据有新增或变动时,可以及时推送至飞书群内,让团队成员及时关注数据变动。如:
- 销售线索推送
- 疫情防控数据预警
1.3 预期效果
1.4 使用说明
若仅需要在群内进行消息推送,无需@群成员,那么任何模式的简道云账号均可进行飞书群消息推送,即钉钉集成模式、企业微信集成模式以及公共模式的用户,均可使用「飞书群消息机器人」插件进行群消息推送。
2. 飞书配置
2.1 添加群机器人
1)登录飞书客户端,进入需要添加群机器人的群聊,点击「设置>>群机器人」。如下图所示:
2)在群机器人列表中选择「自定义机器人」进行添加,如下图所示:
3)依次填写机器人名称、描述后点击「添加」。如下图所示:
2.2 记录参数
在「安全设置处」开启「签名校验」,复制 wehhook 地址和签名密钥这两个参数并进行备份。备份后点击「完成」,如下图所示:
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:飞书群机器人插件安装。
- 安装成功后,可前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「飞书群机器人」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 启用插件
在插件管理中,打开「飞书群机器人」插件右侧开关,启用插件。
4. 表单搭建
插件使用体验可先安装:飞书群机器人插件模板表单。本文将按照示例表单进行讲解。
以销售线索推送为例,新建「销售线索」表单,字段设置如下所示:
字段名称 | 字段类型 |
线索来源 | 单选按钮组 |
公司名称 | 单行文本 |
联系人 | 单行文本 |
联系电话 | 单行文本 |
需求描述 | 多行文本 |
5. 智能助手配置
机器人创建好以后,回到简道云进行群消息推送配置。
5.1 新建智能助手
表单设计完成后,在「扩展功能 >> 智能助手」处,点击「新建智能助手」。
5.2 设置触发动作
对智能助手重命名,触发动作选择「新增数据」,选择以后点击「完成」,进行下一步执行动作配置。如下图所示:
5.3 设置执行动作
执行动作选择【2.1步骤】中安装的「飞书群机器人」插件。然后进一步设置执行动作需要配置的具体内容,设置完毕后点击「完成」。如下图所示:
内容设置:
设置项 | 释义 | 备注 |
推送地址 | 【2.2步骤】中飞书群机器人的 webhook 地址 | |
密钥 | 【2.2步骤】中飞书群机器人的签名校验密钥 | |
消息内容 | 可以自定义编辑文本,也可以点击编辑框右侧的【+】插入表单字段 | |
消息@成员 | 可以选择简道云组织架构中的成员,必须是飞书集成模式的简道云账号设置才有效 | 即简道云中的成员与飞书中的成员相匹配,且该成员在消息推送的群内。 |
消息@所有人 | 可以选择是否@群内所有人,选择「是」后,消息推送时将@群内所有成员 |
5.4 保存并返回
全部设置好以后,点击「保存」并返回表单访问界面。
5.5 效果演示
效果参见本文【1.3 预期效果】