微信公众平台开发(89) 高级群发接口_PHP教程

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

本文分为以下四个部分：

一、准备群发内容

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

1. 文本内容

文本内容就是一段文字，比如：""

立即学习“PHP免费学习笔记（深入）”；

2. 图片、语音、视频

要求如下：

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

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

3. 图文

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

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

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

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

<span>"articles"<span :>"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p"<span>"author":"xxx"<span>"title":"Happy Day"<span>"content_source_url":"www.qq.com"<span>"content":"content"<span>"digest":"digest"<span>"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p"<span>"author":"xxx"<span>"title":"Happy Day"<span>"content_source_url":"www.qq.com"<span>"content":"content"<span>"digest":"digest"<span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>

参数说明如下：

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

<span>[] = <span array>("thumb_media_id"=><span>,
                "author"=>"",
                "title"=>"微信公众平台开发",
                "content_source_url" =>"",
                "content" =>"",
                "digest" =>""<span><span>[] = <span array>("thumb_media_id"=><span>,
                "author"=>"方倍工作室",
                "title"=>"微信公众平台开发入门教程",
                "content_source_url" =>"http://m.cnblogs.com/99079/3153567.html?full=1",
                "content" =>"<span sdk>",
                "digest" =>"微信公众平台开发经典的入门教程，学习微信公众平台开发必经之路！"<span><span>[] = <span array>("thumb_media_id"=><span>,
                "author"=>"方倍工作室",
                "title"=>"微信公众平台开发最佳实践",
                "content_source_url" =>"http://m.cnblogs.com/?u=txw1958",
                "content" =>"<p>本书共分10章，案例程序采用广泛流行的PHP、MySQL、XML、CSS、JavaScript、HTML5等程序语言及数据库实现。系统完整地介绍微信公众平台基础接口、自定义菜单、高级接口、微信支付、分享转发等所有相关技术，以生活类、娱乐类、企业类微信开发为切入点，讲解了30多个功能或应用案例。<br>本书按照从简单到复杂，从基础到实践的方式编排，在讲解过程中注重将原理和实践相结合。初学者可以在了解PHP和MySQL语法之后，从头至尾学习，对于其中难以理解的部分可以查阅相关资料，针对企业功能类的开发还需要具有一定的JavaScript、CSS、HTML等编程基础。<br>本书可以作为微信公众平台开发的教程。对于移动互联网及微信公众平台的相关从业人员，本书也具有极大的参考价值。</p>",
                "digest" =>"微信公众平台开发含金量最高的书籍"<span></span></span></span></span></span></span></span></span></span></span></span></span></span>

上传图文消息素材的代码则实现如下：

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

<span>"type":"news",
    "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
    "created_at":1391857799<span></span></span>

二、选择群发对象

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

1.用户组

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

2.OpenID列表

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

三、执行群发

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

1. 对用户组群发

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

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

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

文本：

<span>"filter"<span :>"group_id":"2"<span>"text"<span :>"content":"CONTENT"<span>"msgtype":"text"<span></span></span></span></span></span></span>

淘特微信宝

淘特微信宝是淘特CMS团队最新研制的微信公众平台管理工具包，该产品提供一个后台管理多个微信公众号功能，可以一站式管理多个微信公众号的自动回复消息、自定义菜单等功能，通过后台可视化操作免去微信接口程序开发的繁锁工作，令不懂程序的人也能灵活管理微信公众号。

下载

<span>"filter"<span :>"group_id":"2"<span>"voice"<span :>"media_id":"123dsdajkasd231jhksad"<span>"msgtype":"voice"<span></span></span></span></span></span></span>

<span>"filter"<span :>"group_id":"2"<span>"image"<span :>"media_id":"123dsdajkasd231jhksad"<span>"msgtype":"image"<span></span></span></span></span></span></span>

<span>"filter"<span :>"group_id":"2"<span>"mpvideo"<span :>"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"<span>"msgtype":"mpvideo"<span></span></span></span></span></span></span>

<span>"filter"<span :>"group_id":"2"<span>"mpnews"<span :>"media_id":"123dsdajkasd231jhksad"<span>"msgtype":"mpnews"<span></span></span></span></span></span></span>

相关参数说明如下：

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

返回结果如下：

<span array>(3<span>"errcode"]=><span int>0<span>"errmsg"]=>
  <span string>(27) "send job submission success"<span>"msg_id"]=>
  <span float>(2347614963<span></span></span></span></span></span></span></span></span>

参数说明

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

2.对OpenID列表群发

接口如下：

POST数据示例如下：
文本：

<span>"touser":<span>"oR5Gjjl_eiZoUpGozMo7dbBJ362A", 
        "oR5Gjjo5rXlMUocSEXKT7Q5RQ63Q"<span>, 
    "msgtype": "text", 
    "text":<span>"content": "hello from boxer."<span></span></span></span></span></span>

语音：

<span>"touser":<span>"OPENID1",
        "OPENID2"<span>,
   "voice":<span>"media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"<span>,
   "msgtype":"voice"<span></span></span></span></span></span></span>

图片：

<span>"touser":<span>"OPENID1",
    "OPENID2"<span>,
   "image":<span>"media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"<span>,
   "msgtype":"image"<span></span></span></span></span></span></span>

<span>"touser":<span>"OPENID1",
        "OPENID2"<span>,
   "video":<span>"media_id":"123dsdajkasd231jhksad",
      "title":"TITLE",
      "description":"DESCRIPTION"<span>,
   "msgtype":"video"<span></span></span></span></span></span></span>

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

<span>"touser":<span>"OPENID1",
        "OPENID2"<span>,
   "mpnews":<span>"media_id":"123dsdajkasd231jhksad"<span>,
   "msgtype":"mpnews"<span></span></span></span></span></span></span>

参数列表

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

<span>"errcode":0,
    "errmsg":"send job submission success",
    "msg_id":<span>2347614964</span><span></span></span>

四、接收群发结果   

1. 设置公众号助手

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

2. 接收结果事件

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

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

<span><span xml><span>
    <span><span tousername><span><span><span gh_3e8adccde292><span><span><span tousername><span>
    <span><span fromusername><span><span><span or5gjjl_eizoupgozmo7dbbj362a><span><span><span fromusername><span>
    <span><span createtime><span>1394524295<span><span createtime><span>
    <span><span msgtype><span><span><span event><span><span><span msgtype><span>
    <span><span event><span><span><span masssendjobfinish><span><span><span event><span>
    <span><span msgid><span>1988<span><span msgid><span>
    <span><span status><span><span><span sendsuccess><span><span><span status><span>
    <span><span totalcount><span>100<span><span totalcount><span>
    <span><span filtercount><span>80<span><span filtercount><span>
    <span><span sentcount><span>75<span><span sentcount><span>
    <span><span errorcount><span>5<span><span errorcount><span>
<span><span xml><span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>

从上可以看出，这其实是公众号群发助手模拟向公众号发送消息，那么群发结果也是返回给公众号助手。

在微信公众平台PHP SDK中增加该事件消息的处理结果如下：

<span private> <span function> receiveEvent(<span><span><span> = ""<span><span switch> (<span>-><span event><span case> "subscribe":
            <span> = "欢迎关注方倍工作室"<span><span break><span><span case> "MASSSENDJOBFINISH":
            <span> = "消息ID：".<span>->MsgID.
                       "\n结果：".<span>->Status.
                       "\n粉丝数：".<span>->TotalCount.
                       "\n过滤：".<span>->FilterCount.
                       "\n发送成功：".<span>->SentCount.
                       "\n发送失败：".<span>-><span errorcount><span break><span><span default>:
            <span break><span><span> = <span>->transmitText(<span>, <span><span><span return> <span><span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>

====================================================================

方倍工作室微信公众平台账号关注方法：
1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
2. 微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
3. 使用微信扫描下面的二维码