企业微信群机器人插件
1. 简介
1.1 插件简介
企业微信群机器人插件:即在表单处完成相关配置,当表单数据发生变动时,借助群机器人,自动将数据推送到企业微信群内。
1.2 应用场景
- 疫情防控场景中,可以通过微信群机器人插件及时推送员工异常体温数据到疫情防控群中;
- 销售管理场景中,可以定期推送销售线索、售后工单等到业务群中,方便对应负责人及时分配任务。
1.3 预期效果
以疫情防控下,每日体温上报后,对异常体温进行群消息推送提醒为例,不同消息提醒的效果如下所示:
1)文本消息提醒
2)图文消息提醒
3)markdown消息提醒
1.4 使用说明
任何模式的简道云账号均可进行企业微信群消息推送,即钉钉集成模式、企业微信集成模式以及公共模式的用户,均可使用「企业微信群消息机器人」插件进行群消息推送。
2. 企业微信配置
2.1 添加群机器人
1)在企业微信群中选中需要添加机器人的群,鼠标右键后选择「管理聊天信息」,在聊天信息中选择「添加群机器人」。
2)在「添加机器人」页面中,点击「新创建一个机器人」,输入机器人的名称后,点击「添加机器人」即可创建成功。
注:由于企业微信的设置,导致部分群可能无法添加群机器人,详情参见企业微信官方文档:查看原因。
2.2 记录参数
1)机器人添加成功后,将机器人中的 webhook 地址复制并保存。
2)如果没有及时进行复制和保存备份,或在插件配置过程中出现失败情况,需要重新查看 webhook 地址,可以从企业微信群中进行查看。
注:在一个群里只需要添加一个机器人,多张表单的数据都可以由同一个群消息机器人来推。
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:企业微信群机器人插件安装。
- 安装成功后,可前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「企业微信群机器人」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 启用插件
在插件管理中,打开「企业微信群机器人」插件右侧开关,启用插件。
4. 表单搭建
插件使用体验可先安装:企业微信群机器人插件模板表单。本文将按照示例表单进行讲解。
以「疫情数据监控」为例,新建「每日体温上报」表单,字段设置如下所示:
字段名称 | 字段类型 |
员工姓名 | 成员单选 |
员工部门 | 部门单选 |
日期 | 日期时间 |
当日体温 | 数字 |
体温照片 | 图片 |
当日活动 | 单行文本 |
5. 智能助手配置
5.1 添加智能助手
表单设计完成后,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,并修改智能助手的名称为「异常体温提醒」:
5.2 设置触发动作
由于我们是对异常体温数据进行推送,故触发动作设置如下:
- 触发动作:选择「新增数据」;
- 触发表单:选择「每日体温上报」;
- 触发条件:「当日体温」 大于 37.5 度;
设置完成后点击「完成」。
5.3 设置执行动作
本章节的【5.3.1 markdown 消息配置】、【5.3.2 图文消息配置】和【5.3.3 文本消息配置】并非全部需要配置,企业可根据自己实际业务情况按需配置即可。
5.3.1 markdown消息配置
若选择 markdown 消息类提醒,则执行动作设置如下:
- 执行动作:选择「企业微信群机器人」插件,下拉框选择「markdown 消息」;
- 推送地址:设置为自定义,将【2.2 记录参数】中的 webhook 地址复制进来;
- 消息模板:设置为组合,模板内容可设置如下:
- 员工姓名:点击右侧「+」号添加表单字段「员工姓名」;
- 员工部门:点击右侧「+」号添加表单字段「员工部门」;
- 今日体温:点击右侧「+」号添加表单字段「当日体温」;
- 当日活动:点击右侧「+」号添加表单字段「当日体温」;
全部设置完成后,点击「完成」按钮。
注:您可使用 markdown 语法,为消息模板设置相应的样式。详细语法可参考文档:群消息配置说明-markdown类型。
5.3.2 图文消息配置
若选择图文消息类提醒,则执行动作设置如下:
- 执行动作:选择「企业微信群机器人」插件,下拉框选择「图文消息」;
- 推送地址:设置为自定义,将【2.2 记录参数】中的 webhook 地址复制进来;
- 消息标题:设置为自定义,企业可根据需求进行填写,如填写为员工体温异常通知;
- 消息描述:设置为组合,模板内容可设置如下:
- 员工姓名:点击右侧「+」号添加表单字段「员工姓名」;
- 员工部门:点击右侧「+」号添加表单字段「员工部门」;
- 今日体温:点击右侧「+」号添加表单字段「当日体温」;
- 当日活动:点击右侧「+」号添加表单字段「当日体温」;
- 消息跳转链接:设置为字段值,即选择为「数据链接」字段;
- 图片链接:设置为组合,点击右侧「+」号添加表单字段「体温照片(URL)」。
全部设置完成后,点击「完成」按钮。
5.3.3 文本消息配置
若选择文本消息类提醒,则执行动作设置如下:
- 执行动作:选择「企业微信群机器人」插件,下拉框选择「文本类型」;
- 推送地址:设置为自定义,将【2.2 记录参数】中的 webhook 地址复制进来;
- 消息模板:设置为组合,模板内容可设置如下:
- 员工姓名:点击右侧「+」号添加表单字段「员工姓名」;
- 员工部门:点击右侧「+」号添加表单字段「员工部门」;
- 今日体温:点击右侧「+」号添加表单字段「当日体温」;
- 当日活动:点击右侧「+」号添加表单字段「当日体温」;
- 消息@群成员:设置为@所有人。
全部设置完成后,点击「完成」按钮。
注:如果不是企业微信模式的账号,且@的指定成员不在推送消息的企业微信群里,则只推送消息,无法@指定群成员。
5.4 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
如果您属于以下两种情况之一:
- 2022.6.20 之后,原 企业微信集成模式 的用户进行过 解绑重新绑定企微 或 从第三方应用换绑到自建应用 操作的企业;
- 2022.7.31 之后,在企业微信端「新安装」简道云 应用的企业。
则插件配置中的【消息@群成员】将不再生效,即无法再在插件执行后@指定的群成员。但除此项配置外,插件的其他配置仍可正常生效,给您带来不便还请谅解。