text消息
{
"msgtype": "text",
"text": {
"content": "张三的请假申请"
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:text |
content |
String |
是 |
消息内容 |
text消息展现

image消息
{
"msgtype": "image",
"image": {
"media_id": "MEDIA_ID"
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:image |
media_id |
String |
是 |
图片媒体文件id,可以调用上传媒体文件接口获取。建议宽600像素 x 400像素,宽高比3:2 |
img消息展现

voice消息
{
"msgtype": "voice",
"voice": {
"media_id": "MEDIA_ID",
"duration": "10"
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:voice |
media_id |
String |
是 |
语音媒体文件id,可以调用上传媒体文件接口获取。2MB,播放长度不超过60s,AMR格式 |
duration |
String |
否 |
正整数,小于60,表示音频时长 |
voice消息展现

file消息
{
"msgtype": "file",
"file": {
"media_id": "MEDIA_ID"
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:file |
media_id |
String |
是 |
媒体文件id,可以调用上传媒体文件接口获取。10MB |
file消息展现

link消息
{
"msgtype": "link",
"link": {
"messageUrl": "http://s.dingtalk.com/market/dingtalk/error_code.php",
"picUrl":"@lALOACZwe2Rk",
"title": "测试",
"text": "测试"
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:link |
link消息体格式
参数 |
参数类型 |
必须 |
说明 |
link.messageUrl |
String |
是 |
消息点击链接地址 |
link.picUrl |
String |
是 |
图片媒体文件id,可以调用上传媒体文件接口获取 |
link.title |
String |
是 |
消息标题 |
link.text |
String |
是 |
消息描述 |
link消息展现

OA消息
{
"msgtype": "oa",
"oa": {
"message_url": "http://dingtalk.com",
"head": {
"bgcolor": "FFBBBBBB",
"text": "头部标题"
},
"body": {
"title": "正文标题",
"form": [
{
"key": "姓名:",
"value": "张三"
},
{
"key": "年龄:",
"value": "20"
},
{
"key": "身高:",
"value": "1.8米"
},
{
"key": "体重:",
"value": "130斤"
},
{
"key": "学历:",
"value": "本科"
},
{
"key": "爱好:",
"value": "打球、听音乐"
}
],
"rich": {
"num": "15.6",
"unit": "元"
},
"content": "大段文本大段文本大段文本大段文本大段文本大段文本大段文本大段文本大段文本大段文本大段文本大段文本",
"image": "@lADOADmaWMzazQKA",
"file_count": "3",
"author": "李四 "
}
}
}
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:oa |
OA消息体内容
参数说明
参数 |
参数类型 |
必须 |
说明 |
oa.message_url |
String |
是 |
客户端点击消息时跳转到的H5地址 |
oa.pc_message_url |
String |
否 |
PC端点击消息时跳转到的H5地址 消息链接能在PC端打开 |
oa.head |
String |
是 |
消息头部内容 |
oa.head.bgcolor |
String |
是 |
消息头部的背景颜色。长度限制为8个英文字符,其中前2为表示透明度,后6位表示颜色值。不要添加0x |
oa.head.text |
String |
是 |
消息的头部标题(向普通会话发送时有效,向企业会话发送时会被替换为微应用的名字),长度限制为最多10个字符 |
oa.body |
Array[JSON Object] |
是 |
消息体 |
oa.body.title |
String |
否 |
消息体的标题 |
oa.body.form |
Array[JSON Object] |
否 |
消息体的表单,最多显示6个,超过会被隐藏 |
oa.body.form.key |
String |
否 |
消息体的关键字 |
oa.body.form.value |
String |
否 |
消息体的关键字对应的值 |
oa.body.rich |
JSON Object |
否 |
单行富文本信息 |
oa.body.rich.num |
String |
否 |
单行富文本信息的数目 |
oa.body.rich.unit |
String |
否 |
单行富文本信息的单位 |
oa.body.content |
String |
否 |
消息体的内容,最多显示3行 |
oa.body.image |
String |
否 |
消息体中的图片media_id |
oa.body.file_count |
String |
否 |
自定义的附件数目。此数字仅供显示,钉钉不作验证 |
oa.body.author |
String |
否 |
自定义的作者名字 |
OA消息展现

markdown消息
{
"msgtype": "markdown",
"markdown": {
"title": "首屏会话透出的展示内容",
"text": "# 这是支持markdown的文本 \n## 标题2 \n* 列表1 \n"
}
}
说明:目前只支持md语法的子集,具体支持的元素如下:
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
引用
> A man who stands for nothing will fall for anything.
文字加粗、斜体
**bold**
*italic*
链接
[this is a link](http://name.com)
图片

无序列表
- item1
- item2
有序列表
1. item1
2. item2
参数说明
参数 |
参数类型 |
必须 |
说明 |
msgtype |
String |
是 |
消息类型,此时固定为:markdown |
title |
String |
是 |
首屏会话透出的展示内容 |
text |
String |
是 |
markdown格式的消息 |
Markdown消息展现

ActionCard消息
ActionCard消息支持整体跳转ActionCard样式和独立跳转ActionCard样式:
* 整体跳转ActionCard样式,支持一个点击Action,需要传入参数single_title和single_url;
* 独立跳转ActionCard样式,支持多个点击Action,需要传入参数btn_orientation和btn_json_list;
整体跳转ActionCard样式参数示例:
{
"msgtype": "action_card",
"action_card": {
"title": "是透出到会话列表和通知的文案",
"markdown": "支持markdown格式的正文内容",
"single_title": "查看详情",
"single_url": "https://open.dingtalk.com"
}
}
独立跳转ActionCard样式参数示例:
{
"msgtype": "action_card",
"action_card": {
"title": "是透出到会话列表和通知的文案",
"markdown": "支持markdown格式的正文内容",
"btn_orientation": "1",
"btn_json_list": [
{
"title": "一个按钮",
"action_url": "https://www.taobao.com"
},
{
"title": "两个按钮",
"action_url": "https://www.tmall.com"
}
]
}
}
action_card消息体格式
参数 |
参数类型 |
必须 |
说明 |
action_card.title |
String |
是 |
透出到会话列表和通知的文案 |
action_card.markdown |
String |
是 |
消息内容,支持markdown,语法参考标准markdown语法。图片举例: |
action_card.single_title |
String |
否 |
使用整体跳转ActionCard样式时的标题,必须与single_url同时设置 |
action_card.single_url |
String |
否 |
使用整体跳转ActionCard样式时的链接url,必须与single_title同时设置 |
action_card.btn_orientation |
String |
否 |
使用独立跳转ActionCard样式时的按钮排列方式,竖直排列(0),横向排列(1);必须与btn_json_list同时设置 |
action_card.btn_json_list |
JSONArray |
否 |
使用独立跳转ActionCard样式时的按钮列表;必须与btn_orientation同时设置 |
action_card.btn_json_list.title |
String |
否 |
使用独立跳转ActionCard样式时的按钮的标题 |
action_card.btn_json_list.action_url |
String |
否 |
使用独立跳转ActionCard样式时的按钮的链接url |
ActionCard消息展现
通过整体跳转ActionCard类型消息发出的消息样式如下:

通过独立跳转ActionCard类型消息发出的消息样式如下:

消息展现示例

消息链接能在PC端打开
在消息文本中可以有URL链接,如果想控制在PC客户端点击链接时,能在PC客户端打开页面而不是外跳到浏览器,可以使用下面的方式:
dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.com&pc_slide=true
其中,url参数代表要打开的链接,必须要做UrlEncode;
pc_slide参数,如果为true代表在PC客户端打开,为false或者不写代表用浏览器打开
FAQ
关于此文档暂时还没有FAQ