钉钉群机器人插件

1. 简介

1.1 插件简介

钉钉群机器人插件，是指在表单处完成相关配置，当表单数据发生变动时，借助群机器人，自动将数据推送到钉钉群内。

1.2 使用场景

1.3 预期效果

以销售管理场景中推送销售线索为例，效果如下所示：

2. 钉钉平台配置

2.1 创建企业内部应用

1）登录 钉钉开放平台，在「应用开发 >> 企业内部应用 >> 钉钉应用」处，点击「创建应用」：

2）在创建应用的详情页中，设置应用名称、应用描述和应用图标。设置完成后，点击「保存」按钮。

2.2 创建机器人

1）应用创建完成后，进入应用开发页面中，在「应用能力 >> 添加应用能力」处，选择机器人，并点击「添加」按钮，如下所示：

2）在机器人配置页面，进行如下所示操作：

设置完成后，点击「发布」按钮。

2.3 发布应用

在「版本管理与发布」处，点击「查看版本详情」并点击「编辑」按钮，修改应用可见范围为「全部员工」。修改完成后，保存并发布当前应用。

2.4 添加群机器人

1）在钉钉群中选中需要添加机器人的内部群，点击内部群右上角的「设置」按钮，在群设置页面中选择「群机器人」。

2）进入机器人管理页面，选择刚刚创建并发布好的机器人「小简同学」。如下所示：

2.5 记录参数

添加完毕后，将 webhook 推送地址这个参数复制并进行备份，供后续智能助手中配置使用。

3. 插件安装及启用

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「钉钉群机器人」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 启用插件

在插件管理中，打开「钉钉群机器人」插件右侧开关，启用插件。

4. 表单搭建

以销售线索推送为例，新建「线索推送」表单，字段设置如下所示：

5. 智能助手配置

5.1 添加智能助手

表单设计完成后，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，并修改智能助手的名称为「线索推送提醒」：

5.2 设置触发动作

由于我们是对新增的线索数据进行推送，故触发动作设置如下：

设置完成后点击「完成」。

5.3 设置执行动作

1）线索数据提交后，触发「钉钉群机器人」插件，故执行动作在「插件」中选择「钉钉群机器人」。

2）进一步设置执行动作，如下图所示：

3）消息推送中还可以开启「@所有人」、「@指定成员」，当消息推送到钉钉群时可以@群内所有成员或者指定的群成员查看消息。

5.4 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

6.1 消息模板

1）消息模板中支持 markdown 语法编排消息。钉钉支持的语法有：

标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

引用
> A man who stands for nothing will fall for anything.

文字加粗、斜体
**bold**
*italic*

链接
[详情点击简道云官网](https://www.jiandaoyun.com)

图片
![](https://example.com/abc.png)

无序列表
- item1
- item2

有序列表
1. item1
2. item2

2）如，可以将数据链接通过 markdown 语法进行写入，插入的图片后台也会转换为图片 url 链接。在群消息查看消息时，就可以直接查看图片和点击配置的链接。效果如下所示：

6.2 签名密钥

若使用钉钉新加的机器人，在钉钉机器人配置过程中不显示密钥内容，则在配置插件时无需填写签名密钥；若之前已经通过钉钉老版本的机器人配置过钉钉群机器人插件，即配置过程中显示「加签」，则在配置插件时需要填写签名密钥，加签处的信息即为密钥信息。如下所示：

6.3 消息@群成员

1）只有钉钉集成模式的账号可以成功@指定群成员，被@的指定成员需要在钉钉群内。

2）机器人「@指定成员」，仅支持内部群，不支持外部协作群。

3）机器人开启「@所有人」的前提是在钉钉群设置中关闭了「仅群主和群管理员可@所有人」，否则钉钉群机器人设置了「@所有人」的消息将执行失败，无法推送。