钉钉集成（自建应用）

当系统已经集成钉钉，那么可以通过此插件访问钉钉相关的接口

已集成钉钉示例

1. 插件介绍

1.1 功能介绍

通过此接口，您可以向指定的成员或部门发送文本消息、Markdown格式信息、
文本卡片等多种类型的消息。

1.2 效果展示

注意：此部分展示了消息通知接口消息卡片类型使用后的效果。
其它类型的效果将在后面展示。

---

2. 消息通知相关接口使用说明

消息通知接口是以某个应用的名义推送到员工的工作通知消息，例如生日祝福、入职提醒等。具体消息类型和样例在后面介绍。

2.1 推送文本消息接口

将文本类型的数据推送到员工的工作通知消息。

接口调用效果如下:

---

参数说明

接口调用时，需要传入以下 参数：

参数名	类型	是否必填	描述
通知内容	文本	✔️	消息内容，最长不超过2048个字节。
通知成员列表	子表		接收者的userid列表，最大用户列表长度100。
通知部门列表	子表		接收者的部门id列表，最大列表长度20。
是否发送给企业全部用户	是否	✔️	是否发送给企业全部用户。

---

使用示例

提示

温馨提醒：通知内容，建议500字符以内。

---

2.2 推送markdown消息接口

将markdown类型的数据推送到员工的工作通知消息。

接口调用效果如下:

---

参数说明

接口调用时，需要传入以下 参数：

参数名	类型	是否必填	描述
通知内容(markdown文本)	文本	✔️	markdown格式的消息，最大不超过5000字符。
通知成员列表	子表		接收者的userid列表，最大用户列表长度100。
通知部门列表	子表		接收者的部门id列表，最大列表长度20。
是否发送给企业全部用户	是否	✔️	是否发送给企业全部用户。
标题	文本	✔️	首屏会话透出的展示内容。

---

使用示例

提示

温馨提醒：markdown语法在引导中有简单介绍

---

2.3 推送消息卡片接口

将消息卡片类型的数据推送到员工的工作通知消息。

接口调用效果如下:

---

参数说明

接口调用时，需要传入以下 参数：

参数名	类型	是否必填	描述
通知内容(markdown文本)	文本	✔️	markdown格式的消息，最大不超过5000字符。
通知成员列表	子表		接收者的userid列表，最大用户列表长度100。
通知部门列表	子表		接收者的部门id列表，最大列表长度20。
是否发送给企业全部用户	是否	✔️	是否发送给企业全部用户。
标题	文本	✔️	首屏会话透出的展示内容。
跳转列表	子表	✔️	跳转链接配置列表
跳转列表.跳转关键字	文本	✔️	跳转选项的标题。必须与跳转地址同时设置，最长20个字符。
跳转列表.跳转地址	文本	✔️	消息点击链接地址,最长500个字符。
跳转排列方式	单选		配置多个跳转链接的排列方式（单个不需要传递）

提示

说明：当是否发送给企业全部用户设置为否时必须指定userid_list或dept_id_list其中一个参数的值。

---

使用示例

提示

温馨提醒：markdown语法在引导中有简单介绍