目录

接口定义

消息类型

文本消息

图片消息

语音消息

视频消息

文件消息

文本卡片消息

图文消息

图文消息（mpnews）

markdown消息

小程序通知消息

模板卡片消息

文本通知型

图文展示型

按钮交互型

投票选择型

多项选择型

附录

支持的markdown语法

id转译说明

接口定义

应用支持推送文本、图片、视频、文件、图文等类型。

请求方式： POST（ HTTPS ）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

参数说明：

- 各个消息类型的具体POST格式请阅后续“消息类型”部分。
- 如果有在管理端对应用设置“在微工作台中始终进入主页”，应用在微信端只能接收到文本消息，并且文本消息的长度限制为20字节，超过20字节会被截断。同时其他消息类型也会转换为文本消息，提示用户到企业微信查看。
- 支持id转译，将userid/部门id转成对应的用户名/部门名，目前仅 文本/文本卡片/图文/图文（mpnews）/任务卡片/小程序通知/模版消息/模板卡片消息 这八种消息类型的 部分字段 支持。仅第三方应用需要用到，企业自建应用可以忽略。具体支持的范围和语法，请查看附录 id转译说明 。
- 支持重复消息检查，当指定 "enable_duplicate_check": 1 开启: 表示在一定时间间隔内，同样内容（请求json）的消息，不会重复收到；时间间隔可通过 duplicate_check_interval 指定，默认 1800秒 。
- 从2021年2月4日开始，企业关联添加的「小程序」应用，也可以发送文本、图片、视频、文件、图文等各种类型的消息了。
调用建议 ：大部分企业应用在每小时的0分或30分触发推送消息，容易造成资源挤占，从而投递不够及时，建议尽量避开这两个时间点进行调用。
频率限制 ：每应用不可超过账号上限数*200人次/天（注：若调用api一次发给1000人，算1000人次；若企业账号上限是500人，则每个应用每天可发送100000人次的消息）。每应用对同一个成员不可超过30次/分钟，超过部分会被丢弃不下发

返回示例：

如果部分接收人无权限或不存在，发送仍然执行，但会返回无效的部分（即invaliduser或invalidparty或invalidtag或unlicenseduser），常见的原因是 接收人不在应用的可见范围内 。
权限包含 应用可见范围 和 基础接口权限 (基础账号、互通账号均可)，unlicenseduser中的用户在应用可见范围内但没有基础接口权限。
如果 全部 接收人无权限或不存在，则本次调用返回失败，errcode为81013。
返回包中的userid，不区分大小写，统一转为小写

参数说明：

消息类型

文本消息

请求示例：

参数说明：

touser、toparty、totag不能同时为空 ，后面不再强调。

文本消息展现：

特殊说明：
其中text参数的content字段可以支持换行、以及A标签，即可打开自定义的网页（可参考以上示例代码）(注意：换行符请用转义过的\n)

图片消息

请求示例：

请求参数：

语音消息

请求示例：

参数说明：

视频消息

请求示例：

参数说明：

视频消息展现：

文件消息

请求示例：

参数说明：

文件消息展现：

文本卡片消息

请求示例：

参数说明：

文本卡片消息展现 ：

特殊说明 ：
卡片消息的展现形式非常灵活，支持使用br标签或者空格来进行换行处理，也支持使用div标签来使用不同的字体颜色，目前内置了3种文字颜色：灰色(gray)、高亮(highlight)、默认黑色(normal)，将其作为div标签的class属性即可，具体用法请参考上面的示例。

图文消息

请求示例：

参数说明：

图文消息展现：

图文消息（mpnews）

mpnews类型的图文消息，跟普通的图文消息一致，唯一的差异是图文内容存储在企业微信。
多次发送mpnews，会被认为是不同的图文，阅读、点赞的统计会被分开计算。

请求示例：

参数说明：

markdown消息

目前仅支持 markdown语法的子集
微工作台（原企业号）不支持展示markdown消息

请求示例：

示例效果：

参数说明：

小程序通知消息

小程序通知消息只允许绑定了小程序的应用发送， 之前，消息会通过统一的会话【小程序通知】发送给用户 。
从2019年6月28日起，用户收到的小程序通知会出现在各个独立的应用中。
不支持@all全员发送
微工作台（原企业号）不支持展示小程序通知消息

请求示例：

示例效果：

参数说明：

模板卡片消息

投票选择型和多项选择型卡片仅企业微信3.1.12及以上版本支持
文本通知型、图文展示型和按钮交互型三种卡片仅企业微信3.1.6及以上版本支持（但附件下载功能仍需更新至3.1.12）
微工作台（原企业号）不支持展示模板卡片消息

3.1.18版本新增

1. source字段支持设置字体颜色
2. horizontal_content_list新增type 3，代表点击跳转成员详情（仅企业微信3.1.18及以上版本支持）
3. 新增action_menu(右上角菜单)（仅企业微信3.1.18及以上版本支持）
4. quote_area(引用样式)、image_text_area(左图右文样式)、button_selection(按钮型卡片的下拉框样式)等字段

特殊说明

1. 仅有 按钮交互型、投票选择型、多项选择型 以及填写了action_menu字段的文本通知型、图文展示型的卡片支持回调更新或通过接口更新卡片。
2. 支持回调更新的卡片可支持用户点击触发交互事件，需要开发者设置的回调接口来处理回调事件，回调协议可见文档 模板卡片事件推送 ，注意 没有配置回调接口的应用不可发送支持回调的卡片 。
3. 开发者的服务收到回调事件后，需要根据协议返回相应的数据以更新卡片，对应的协议见文档 更新模版卡片消息 。
4. 此接口发送支持回调更新的卡片消息之后，返回的参数里会带上response_code，可使用response_code调用 更新模版卡片消息 接口， response_code 72小时内有效，且只能调用一次接口 。

文本通知型

参数说明：

图文展示型

按钮交互型

备注：
按钮样式

投票选择型

参数说明：

多项选择型

参数说明：

附录

支持的markdown语法

目前应用消息中支持的markdown语法是如下的子集：

1. 标题 （支持1至6级标题，注意#与文字中间要有空格）
   

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

   **bold**

   [这是一个链接](http://work.weixin.qq.com/api/doc)

2. 行内代码段（暂不支持跨行）
   

   `code`

3. 字体颜色(只支持3种内置颜色)
   

   <font color="info">绿色</font>
   <font color="comment">灰色</font>
   <font color="warning">橙红色</font>

id转译说明

1.支持的消息类型和对应的字段