在这篇微信公众平台高级接口开发教程中，我们将介绍如何使用接口实现微信公众平台群发功能。

本文分为以下四个部分：

1. 准备群发内容
2. 选择群发对象
3. 执行群发
4. 接收群发结果

群发内容可以是文本、图片、语音、视频、图文。群发文本只需要文本内容，其他内容需要获得相应的media_id。

文本内容就是一段文字，比如："微信公众平台开发最佳实践"

要求如下：

• Ÿ 图片（image）: 128K，支持JPG格式
• Ÿ 语音（voice）：256K，播放长度不超过60s，支持AMR\MP3格式
• Ÿ 视频（video）：1MB，支持MP4格式

准备好以后，需要使用上传下载多媒体文件接口将其上传到微信服务器，获得media_id。上传的开发方法，可以参考本博客的第80篇教程微信公众平台开发(80) 上传下载多媒体文件

首先要准备缩略图，要求如下：

• 缩略图（thumb）：64KB，支持JPG格式

同样的，使用上传下载多媒体文件接口，上传到微信服务器后，得到缩略图的media_id，然后需要使用上传图文消息素材接口将其上传到微信服务器，接口为

https://api.weixin.QQ.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN

要POST提交的数据示例如下：

{    "articles": [        {            "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",            "author":"xxx",            "title":"Happy Day",            "content_source_url":"www.qq.com",            "content":"content",            "digest":"digest"        },        {            "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",            "author":"xxx",            "title":"Happy Day",            "content_source_url":"www.qq.com",            "content":"content",            "digest":"digest"        }    ]}

参数说明如下：

根据上述POST结构，定义图文数组如下：

上传成功后，返回如下，将得到图文消息的media_id

{    "type":"news",    "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",    "created_at":1391857799}

群发对象可以是用户组，也可以是OpenID列表。

获得用户分组，需要使用高级接口中的查询所有分组接口，获得相应的group_id，开发方法，可以参考本博客的第88篇教程微信公众平台开发(88) 用户分组接口

OpenID列表，是使用高级接口中的获取关注者列表接口来实现的。开发方法，可以参考本博客的第87篇教程微信公众平台开发(87) 获取关注者列表

由于群发对象的不同，执行群发也有不同的方式。

对用户组群发的接口如下：

https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

要POST的内容按内容不同组成也不一样。

文本：

{   "filter":{      "group_id":"2"   },   "text":{      "content":"CONTENT"   },    "msgtype":"text"}

语音（注意此处media_id需通过基础支持中的上传下载多媒体文件来得到）：

{   "filter":{      "group_id":"2"   },   "voice":{      "media_id":"123dsdajkasd231jhksad"   },    "msgtype":"voice"}

图片（注意此处media_id需通过基础支持中的上传下载多媒体文件来得到）：

{   "filter":{      "group_id":"2"   },   "image":{      "media_id":"123dsdajkasd231jhksad"   },    "msgtype":"image"}

视频

{   "filter":{      "group_id":"2"   },   "mpvideo":{      "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",   },    "msgtype":"mpvideo"}

图文消息（注意图文消息的media_id需要通过上述方法来得到）：

{   "filter":{      "group_id":"2"   },   "mpnews":{      "media_id":"123dsdajkasd231jhksad"   },    "msgtype":"mpnews"}

相关参数说明如下：

其接口实现代码如下所示：

返回结果如下：

array(3) {  ["errcode"]=>  int(0)  ["errmsg"]=>  string(27) "send job submission success"  ["msg_id"]=>  float(2347614963)}

参数说明

下面是向用户组发送图文消息的效果，分别是接收到图文消息，查看图文消息内容后的效果，

接口如下：

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

POST数据示例如下：文本：

{   "touser": [        "oR5Gjjl_eiZoUpGozMo7dbBJ362A",         "oR5Gjjo5rXlMUocSEXKT7Q5RQ63Q"     ],     "msgtype": "text",     "text": {         "content": "hello from boxer."    }}

语音：

{   "touser":[        "OPENID1",        "OPENID2"   ],   "voice":{      "media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"   },   "msgtype":"voice"}

图片：

{   "touser":[    "OPENID1",    "OPENID2"   ],   "image":{      "media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"   },   "msgtype":"image"}

视频：

{   "touser":[        "OPENID1",        "OPENID2"   ],   "video":{      "media_id":"123dsdajkasd231jhksad",      "title":"TITLE",      "description":"DESCRIPTION"   },   "msgtype":"video"}

图文消息（注意图文消息的media_id需要通过上述方法来得到）：

{   "touser":[        "OPENID1",        "OPENID2"   ],   "mpnews":{        "media_id":"123dsdajkasd231jhksad"   },   "msgtype":"mpnews"}

参数列表

返回数据示例（正确时的JSON返回结果）：

{    "errcode":0,    "errmsg":"send job submission success",    "msg_id":2347614964}

为了能接收群发结果，需要设置公众号助手，结果将推送到绑定的个人微信账号上。其设置如下

群发任务提交后，群发任务可能在一定时间后才完成，因此，群发接口调用时，仅会给出群发任务是否提交成功的提示，若群发任务提交成功，则在群发任务结束时，会向开发者在公众平台填写的开发者URL（callback URL）推送事件。

推送的xml结构如下（发送成功时）：

<xml>    <ToUserName><![CDATA[gh_3e8adccde292]]></ToUserName>    <FromUserName><![CDATA[oR5Gjjl_eiZoUpGozMo7dbBJ362A]]></FromUserName>    <CreateTime>1394524295</CreateTime>    <MsgType><![CDATA[event]]></MsgType>    <Event><![CDATA[MASSSENDJOBFINISH]]></Event>    <MsgID>1988</MsgID>    <Status><![CDATA[sendsuccess]]></Status>    <TotalCount>100</TotalCount>    <FilterCount>80</FilterCount>    <SentCount>75</SentCount>    <ErrorCount>5</ErrorCount></xml>