微信企业号开发之如何发送消息-微信企业号推送消息

企业可以主动发消息给员工，消息量不受限制。

调用接口时，使用Https协议、JSON数据包格式，数据包不需做加密处理。

目前支持文本、图片、语音、视频、文件、图文等消息类型。除了news类型，其它类型的消息可在发送时加上保密选项，保密消息会被打上水印，并且只有接收者才能阅读。

一、发送接口说明

请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

参数说明

参数	必须	说明
access_token	是	调用接口凭证

权限要求

需要管理员对应用有使用权限，对收件人touser、toparty、totag有查看权限，否则本次调用失败。

返回结果

如果对应用或收件人、部门、标签任何一个无权限，则本次发送失败；如果收件人、部门或标签不存在，发送仍然执行，但返回无效的部分。

{ 
   "errcode": 0, 
   "errmsg": "ok", 
   "invaliduser": "UserID1", 
   "invalidparty":"PartyID1", 
   "invalidtag":"TagID1" 
} 

1.
2.
3.
4.
5.
6.
7.

二、消息类型及数据格式

text消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "text", 
   "agentid": "1", 
   "text": { 
       "content": "Holiday Request For Pony(http://xxxxx)" 
   }, 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：text
agentid	是	企业应用的id，整型。可在应用的设置页面查看
content	是	消息内容
safe	否	表示是否是保密消息，0表示否，1表示是，默认0

image消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "msgtype": "image", 
   "agentid": "1", 
   "image": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：image
agentid	是	企业应用的id，整型。可在应用的设置页面查看
media_id	是	媒体资源文件ID
safe	否	表示是否是保密消息，0表示否，1表示是，默认0

voice消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "voice", 
   "agentid": "1", 
   "voice": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：voice
agentid	是	企业应用的id，整型。可在应用的设置页面查看
media_id	是	媒体资源文件ID
safe	否	表示是否是保密消息，0表示否，1表示是，默认0

video消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "video", 
   "agentid": "1", 
   " video": { 
       "media_id": "MEDIA_ID", 
       "title": "Title", 
       "description": "Description" 
   }, 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：video
agentid	是	企业应用的id，整型。可在应用的设置页面查看
media_id	是	媒体资源文件ID
title	否	视频消息的标题
description	否	视频消息的描述
safe	否	表示是否是保密消息，0表示否，1表示是，默认0

file消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "file", 
   "agentid": "1", 
   "file": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：file
agentid	是	企业应用的id，整型。可在应用的设置页面查看
media_id	是	文件ID
safe	否	表示是否是保密消息，0表示否，1表示是，默认0

news消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "news", 
   "agentid": "1", 
   "news": { 
       "articles":[ 
           { 
               "title": "Title", 
               "description": "Description", 
               "url": "URL", 
               "picurl": "PIC_URL", 
           }, 
           { 
               "title": "Title", 
               "description": "Description", 
               "url": "URL", 
               "picurl": "PIC_URL", 
           }     
       ] 
   } 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：news
agentid	是	企业应用的id，整型。可在应用的设置页面查看
title	否	标题
description	否	描述
url	否	点击后跳转的链接。企业可根据url里面带的code参数校验员工的真实身份。具体参考“9 微信页面跳转员工身份查询”
picurl	否	图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图640320，小图8080。如不填，在客户端不显示图片

mpnews消息

注：mpnews消息与news消息类似，不同的是图文消息内容存储在微信后台，并且支持保密选项。

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "mpnews", 
   "agentid": "1", 
   "mpnews": { 
       "articles":[ 
           { 
               "thumb_media_id": "id", 
               "author": "Author", 
               "content_source_url": "URL", 
               "content": "Content" 
               "digest": "Digest description", 
               "show_cover_pic": "0" 
           }, 
           {  
               "thumb_media_id": "id", 
               "author": "Author", 
               "content_source_url": "URL", 
               "content": "Content" 
               "digest": "Digest description", 
               "show_cover_pic": "0" 
           } 
       ] 
       "media_id": "id" 
   } 
   "safe":"0" 
} 
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.

参数	必须	说明
touser	否	UserID列表（消息接收者，多个接收者用‘\|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty	否	PartyID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
totag	否	TagID列表，多个接受者用‘\|’分隔。当touser为@all时忽略本参数
msgtype	是	消息类型，此时固定为：mpnews
agentid	是	企业应用的id，整型。可在应用的设置页面查看
articles	是	图文消息，一个图文消息支持1到10个图文
thumb_media_id	是	图文消息缩略图的media_id, 可以在上传多媒体文件接口中获得。此处thumb_media_id即上传接口返回的media_id
title	是	图文消息的标题
author	否	图文消息的作者
content_source_url	否	图文消息点击“阅读原文”之后的页面链接
content	是	图文消息的内容，支持html标签
digest	否	图文消息的描述
show_cover_pic	否	是否显示封面，1为显示，0为不显示
safe	否	表示是否是保密消息，0表示否，1表示是，默认0