markdown消息通知场景

1. 简介

1.1 场景简介

markdown 消息通知场景是指，通过 markdown 语法来在消息通知模板中插入图片、设置字体样式等操作，从而实现能够使用图文并用的形式进行钉钉群消息通知，满足不同企业的个性化需求。

1.2 应用场景

适用于需要通过图文结合形式进行推广等各类消息推送场景中。如课程上新通知、营销推广通知等等。

1.3 预期效果

以课程上线通知为例，效果如下所示：

2. 插件安装及启用

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：钉钉群机器人插件安装。
安装成功后，可前往「开放平台 >> 插件管理」处启用插件。

2）插件市场处安装

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

2.2 启用插件

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

3. 表单搭建

插件使用体验可先安装：钉钉群机器人插件模板表单。本文将按照示例表单进行讲解。

新建「课程上新表」表单，所需字段及字段设置如下所示：

字段名称	字段类型
课程名称	单行文本
课程链接	单行文本
奖品图片	图片

4. 智能助手配置

4.1 添加智能助手

进入「线索推送」表中，在「扩展功能 >> 智能助手」处新建智能助手「课程上新通知」，设置触发方式为「表单触发」。

4.2 设置触发动作

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

4.3 添加并设置插件节点

点击节点连接线上的加号按钮，添加插件节点，插件节点设置如下：

执行插件：选择「钉钉群机器人 >> 发送 markdown 消息」；
推送地址：将【2.5 记录参数】中获取到的 webhook 地址复制过来；
签名密钥：非必填，可不填；
消息标题：设置为「自定义」，自定义输入消息的标题，如课程上新通知；
消息模板：设置为「组合」，以自定义文字和表单字段的形式，设置消息推送模板；模板内容可设置如下：

# 🎉 新的课程上线啦！

** 📅 课程名称 **：触发数据—课程名称(文本)

** 📍 参与方式 **：点击下方链接进行学习哦～

** 👉 [点击查看课程详情](触发数据—课程链接(文本))**

![]触发数据—课程封面(URL)

消息 @ 群成员：设置为「自定义」，企业可根据实际需求选择，如 @ 所有人。

注：

1）消息模板中的图片字段，若推送时想要显示图片，则需要按照上图所示【![](图片(URL))】的格式进行配置；若仅添加了图片 URL 的字段，则最终推送时显示为图片链接。

2）执行动作中所设置的消息标题，仅在弹窗中显示，不显示在消息正文中。

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

4.4 效果演示

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

5. 注意事项

5.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 链接。在群消息查看消息时，就可以直接查看图片和点击配置的链接。效果如下所示：

5.2 签名密钥

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

5.3 消息@群成员

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

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

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

4）通过前端事件调用插件时，在「消息@群成员」处，支持按照表单内的成员子表单列表进行赋值。

在子表单内设置了不同的负责人，在插件配置时可以选择「按子表单赋值」，即可在钉钉群内@对应的负责人，如下所示：