文本消息通知场景
1. 简介
1.1 场景简介
文本消息通知场景是指,仅依靠文本类提醒完成钉钉群内的消息通知。文本类消息无法进行文本样式、添加图片等设置。
1.2 应用场景
适用于各类仅需文本提醒的通知类场景中,如功能变动通知、文档下架通知、考勤异常通知、内测招募通知等等。
1.3 预期效果
以销售管理场景中推送销售线索为例,效果如下所示:
2. 插件安装及启用
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:钉钉群机器人插件安装。
- 安装成功后,可前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「钉钉群机器人」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 启用插件
在插件管理中,打开「钉钉群机器人」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:钉钉群机器人插件模板表单。本文将按照示例表单进行讲解。
以销售线索推送为例,新建「线索推送」表单,字段设置如下所示:
字段名称 | 字段类型 |
线索来源 | 单选按钮组 |
客户名称 | 单行文本 |
联系人 | |
联系方式 | |
反馈时间 | 日期时间 |
需求描述 | 多行文本 |
4. 智能助手配置
4.1 添加智能助手
进入「线索推送」表中,在「扩展功能 >> 智能助手」处新建智能助手「线索推送提醒」,设置触发方式为「表单触发」。

4.2 设置触发动作
设置触发动作为「新增数据时」。

4.3 添加并设置插件节点
点击节点连接线上的加号按钮,添加插件节点,插件节点设置如下:
- 执行插件:选择「钉钉群机器人 >> 发送文本消息」;
- 推送地址:将【2.5 记录参数】中获取到的 webhook 地址复制过来;
- 签名密钥:非必填,可不填;
- 消息内容:设置为「组合」,以自定义文字和表单字段的形式,设置消息推送模板;
- 消息 @ 群成员:设置为「自定义」,企业可根据实际需求选择,如 @ 所有人。

注:
1)消息模板中的图片字段,若推送时想要显示图片,则需要按照上图所示【)】的格式进行配置;若仅添加了图片 URL 的字段,则最终推送时显示为图片链接。
2)执行动作中所设置的消息标题,仅在弹窗中显示,不显示在消息正文中。
3)消息推送中支持开启「@所有人」、「@指定成员」,当消息推送到钉钉群时可以 @群内所有成员或者指定的群成员查看消息。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 签名密钥
若使用钉钉新加的机器人,在钉钉机器人配置过程中不显示密钥内容,则在配置插件时无需填写签名密钥;若之前已经通过钉钉老版本的机器人配置过钉钉群机器人插件,即配置过程中显示「加签」,则在配置插件时需要填写签名密钥,加签处的信息即为密钥信息。如下所示:
5.2 消息@群成员
1)只有钉钉集成模式的账号可以成功@指定群成员,被@的指定成员需要在钉钉群内。
2)机器人「@指定成员」,仅支持内部群,不支持外部协作群。
3)机器人开启「@所有人」的前提是在钉钉群设置中关闭了「仅群主和群管理员可@所有人」,否则钉钉群机器人设置了「@所有人」的消息将执行失败,无法推送。
4)通过前端事件调用插件时,在「消息@群成员」处,支持按照表单内的成员子表单列表进行赋值。
在子表单内设置了不同的负责人,在插件配置时可以选择「按子表单赋值」,即可在钉钉群内@对应的负责人,如下所示:



400-111-0890
在线咨询