《微信公众平台开发：从零基础到ThinkPHP5高性能框架实践》20.7.4 主动发送消息

对于消息型应用，支持文本、图片、语音、视频、文件、图文、素材图文等消息类型。主页型应用只支持文本消息类型，且文本长度不超过20个字。企业微信还支持文本卡片消息。

主动发送消息的接口如下。

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

主动发送消息时，POST数据示例如下。

1）文本消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "totag":" TagID1 | TagID2 ",    "msgtype":"text",    "agentid":1,    "text":{        "content":"Holiday Request For Pony(http:// xxxxx)"    },    "safe":0}  

2）图片消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "totag":" TagID1 | TagID2 ",    "msgtype":"image",    "agentid":1,    "image":{        "media_id":"MEDIA_ID"    },    "safe":0}  

3）语音消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "totag":" TagID1 | TagID2 ",    "msgtype":"voice",    "agentid":1,    "voice":{        "media_id":"MEDIA_ID"    },    "safe":0}  

4）视频消息类型的数据为：

{    "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}  

5）文件消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "totag":" TagID1 | TagID2 ",    "msgtype":"file",    "agentid":1,    "file":{        "media_id":"MEDIA_ID"    },    "safe":"0"}  

6）图文消息类型的数据为：

{    "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"            }        ]    }}  

7）素材图文消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "totag":" TagID1 | TagID2 ",    "msgtype":"mpnews",    "agentid":1,    "mpnews":{        "articles":[            {                "title":"Title",                "thumb_media_id":"id",                "author":"Author",                "content_source_url":"URL",                "content":"Content",                "digest":"Digest description",                "show_cover_pic":"0"            },            {                "title":"Title",                "thumb_media_id":"id",                "author":"Author",                "content_source_url":"URL",                "content":"Content",                "digest":"Digest description",                "show_cover_pic":"0"            }        ]    }}  

8）文本卡片消息类型的数据为：

{    "touser":"UserID1|UserID2|UserID3",    "toparty":" PartyID1 | PartyID2 ",    "msgtype":"textcard",    "agentid":1,    "textcard":{        "title":"领奖通知",        "description":"<p>2016年9月26日</p> <p>        恭喜你抽中iPhone 7一台，领奖码：xxxx</p><p>请于2016年10月        10日前联系行政同事领取</p>",        "url":"URL"    }}  

上述数据的参数说明如表20-36所示。

表20-36　主动发送消息接口的参数说明

正确提交时，返回的数据示例如下。

{"errcode":0,"errmsg":"ok"}