ホームページ > php教程 > php手册 > 微信公众平台开发(89) 高级群发接口

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

WBOY
リリース: 2016-06-13 09:36:49
オリジナル
1015 人が閲覧しました

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

本文分为以下四个部分:

 

一、准备群发内容

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

1. 文本内容

文本内容就是一段文字,比如:""

2. 图片、语音、视频

要求如下:

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

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

3. 图文

首先要准备缩略图,要求如下:

  • 缩略图(thumb):64KB,支持JPG格式

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

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

<span {
    </span>"articles"<span : [
        {
            </span>"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p"<span ,
            </span>"author":"xxx"<span ,
            </span>"title":"Happy Day"<span ,
            </span>"content_source_url":"www.qq.com"<span ,
            </span>"content":"content"<span ,
            </span>"digest":"digest"<span 
        },
        {
            </span>"thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p"<span ,
            </span>"author":"xxx"<span ,
            </span>"title":"Happy Day"<span ,
            </span>"content_source_url":"www.qq.com"<span ,
            </span>"content":"content"<span ,
            </span>"digest":"digest"<span 
        }
    ]
}</span>
ログイン後にコピー

参数说明如下:

参数是否必须说明
Articles 图文消息,一个图文消息支持1到10条图文
thumb_media_id 图文消息缩略图的media_id,可以在基础支持-上传多媒体文件接口中获得
author 图文消息的作者
title 图文消息的标题
content_source_url 在图文消息页面点击“阅读原文”后的页面
content 图文消息页面的内容,支持HTML标签
digest 图文消息的描述

根据上述POST结构,定义图文数组如下:

<span $news</span>[] = <span array</span>("thumb_media_id"=><span $thumb_media_id1</span>,
                "author"=>"",
                "title"=>"微信公众平台开发",
                "content_source_url" =>"",
                "content" =>"",
                "digest" =>""<span 
                );

</span><span $news</span>[] = <span array</span>("thumb_media_id"=><span $thumb_media_id2</span>,
                "author"=>"方倍工作室",
                "title"=>"微信公众平台开发入门教程",
                "content_source_url" =>"http://m.cnblogs.com/99079/3153567.html?full=1",
                "content" =>"<span <div>
<p>本教程是微信公众平台的入门教程,它将引导你完成如下任务:</p>
<ol>
<li>1. 创建新浪云计算平台应用</li>
<li>2. 启用微信公众平台开发模式</li>
<li>3. 基础接口消息及事件</li>
<li>4. 微信公众平台PHP SDK</li>
<li>5. 微信公众平台开发模式原理</li>
<li>6. 开发天气预报功能</li>
</ol>
</div></span>",
                "digest" =>"微信公众平台开发经典的入门教程,学习微信公众平台开发必经之路!"<span 
                );

</span><span $news</span>[] = <span array</span>("thumb_media_id"=><span $thumb_media_id3</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>
ログイン後にコピー

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

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

<span {
    </span>"type":"news",
    "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
    "created_at":1391857799<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 {
   </span>"filter"<span :{
      </span>"group_id":"2"<span 
   },
   </span>"text"<span :{
      </span>"content":"CONTENT"<span 
   },
    </span>"msgtype":"text"<span 
}</span>
ログイン後にコピー

<span {
   </span>"filter"<span :{
      </span>"group_id":"2"<span 
   },
   </span>"voice"<span :{
      </span>"media_id":"123dsdajkasd231jhksad"<span 
   },
    </span>"msgtype":"voice"<span 
}</span>
ログイン後にコピー

<span {
   </span>"filter"<span :{
      </span>"group_id":"2"<span 
   },
   </span>"image"<span :{
      </span>"media_id":"123dsdajkasd231jhksad"<span 
   },
    </span>"msgtype":"image"<span 
}</span>
ログイン後にコピー

<span {
   </span>"filter"<span :{
      </span>"group_id":"2"<span 
   },
   </span>"mpvideo"<span :{
      </span>"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"<span ,
   },
    </span>"msgtype":"mpvideo"<span 
}</span>
ログイン後にコピー

<span {
   </span>"filter"<span :{
      </span>"group_id":"2"<span 
   },
   </span>"mpnews"<span :{
      </span>"media_id":"123dsdajkasd231jhksad"<span 
   },
    </span>"msgtype":"mpnews"<span 
}</span>
ログイン後にコピー

相关参数说明如下:

参数是否必须说明
filter 用于设定图文消息的接收者
group_id 群发到的分组的group_id
mpnews 用于设定即将发送的图文消息
media_id 用于群发的消息的media_id
msgtype 群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video
title 消息的标题
description 消息的描述
thumb_media_id 视频缩略图的媒体ID

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

返回结果如下:

<span array</span>(3<span ) {
  [</span>"errcode"]=><span 
  int(</span>0<span )
  [</span>"errmsg"]=>
  <span string</span>(27) "send job submission success"<span 
  [</span>"msg_id"]=>
  <span float</span>(2347614963<span )
}</span>
ログイン後にコピー

参数说明

参数说明
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为news
errcode 错误码
errmsg 错误信息
msg_id 消息ID

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

2.对OpenID列表群发

接口如下:

POST数据示例如下:
文本:

<span {
   </span>"touser":<span  [
        </span>"oR5Gjjl_eiZoUpGozMo7dbBJ362A", 
        "oR5Gjjo5rXlMUocSEXKT7Q5RQ63Q"<span  
    ]</span>, 
    "msgtype": "text", 
    "text":<span  { 
        </span>"content": "hello from boxer."<span 
    }
}</span>
ログイン後にコピー

语音:

<span {
   </span>"touser":<span [
        </span>"OPENID1",
        "OPENID2"<span 
   ]</span>,
   "voice":<span {
      </span>"media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"<span 
   }</span>,
   "msgtype":"voice"<span 
}</span>
ログイン後にコピー

图片:

<span {
   </span>"touser":<span [
    </span>"OPENID1",
    "OPENID2"<span 
   ]</span>,
   "image":<span {
      </span>"media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"<span 
   }</span>,
   "msgtype":"image"<span 
}</span>
ログイン後にコピー

<span {
   </span>"touser":<span [
        </span>"OPENID1",
        "OPENID2"<span 
   ]</span>,
   "video":<span {
      </span>"media_id":"123dsdajkasd231jhksad",
      "title":"TITLE",
      "description":"DESCRIPTION"<span 
   }</span>,
   "msgtype":"video"<span 
}</span>
ログイン後にコピー

图文消息(注意图文消息的media_id需要通过上述方法来得到):

<span {
   </span>"touser":<span [
        </span>"OPENID1",
        "OPENID2"<span 
   ]</span>,
   "mpnews":<span {
        </span>"media_id":"123dsdajkasd231jhksad"<span 
   }</span>,
   "msgtype":"mpnews"<span 
}</span>
ログイン後にコピー

参数列表

参数是否必须说明
touser 填写图文消息的接收者,一串OpenID列表,OpenID最少个,最多10000个
mpnews 用于设定即将发送的图文消息
media_id 用于群发的图文消息的media_id
msgtype 群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video
title 消息的标题
description 消息的描述
thumb_media_id 视频缩略图的媒体ID

返回数据示例(正确时的JSON返回结果):

<span {
    </span>"errcode":0,
    "errmsg":"send job submission success",
    "msg_id":<span>2347614964</span><span 
}</span>
ログイン後にコピー

四、接收群发结果

1. 设置公众号助手

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

2. 接收结果事件

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

推送的XML结构如下(发送成功时):

<span <</span><span xml</span><span ></span>
    <span <</span><span ToUserName</span><span ></span><span <![CDATA[</span><span gh_3e8adccde292</span><span ]]></span><span </</span><span ToUserName</span><span ></span>
    <span <</span><span FromUserName</span><span ></span><span <![CDATA[</span><span oR5Gjjl_eiZoUpGozMo7dbBJ362A</span><span ]]></span><span </</span><span FromUserName</span><span ></span>
    <span <</span><span CreateTime</span><span ></span>1394524295<span </</span><span CreateTime</span><span ></span>
    <span <</span><span MsgType</span><span ></span><span <![CDATA[</span><span event</span><span ]]></span><span </</span><span MsgType</span><span ></span>
    <span <</span><span Event</span><span ></span><span <![CDATA[</span><span MASSSENDJOBFINISH</span><span ]]></span><span </</span><span Event</span><span ></span>
    <span <</span><span MsgID</span><span ></span>1988<span </</span><span MsgID</span><span ></span>
    <span <</span><span Status</span><span ></span><span <![CDATA[</span><span sendsuccess</span><span ]]></span><span </</span><span Status</span><span ></span>
    <span <</span><span TotalCount</span><span ></span>100<span </</span><span TotalCount</span><span ></span>
    <span <</span><span FilterCount</span><span ></span>80<span </</span><span FilterCount</span><span ></span>
    <span <</span><span SentCount</span><span ></span>75<span </</span><span SentCount</span><span ></span>
    <span <</span><span ErrorCount</span><span ></span>5<span </</span><span ErrorCount</span><span ></span>
<span </</span><span xml</span><span ></span>
ログイン後にコピー
参数说明
ToUserName 公众号的微信号
FromUserName 公众号群发助手的微信号,为mphelper
CreateTime 创建时间的时间戳
MsgType 消息类型,此处为event
Event 事件信息,此处为MASSSENDJOBFINISH
MsgID 群发的消息ID
Status 群发的结构,为“send success”或“send fail”或“err(num)”。但send success时,也有可能因用户拒收公众号的消息、系统错误等原因造成少量用户接收失败。err(num)是审核失败的具体原因,可能的情况如下:

err(10001), //涉嫌广告 err(20001), //涉嫌政治 err(20004), //涉嫌社会 err(20002), //涉嫌色情 err(20006), //涉嫌违法犯罪 err(20008), //涉嫌欺诈 err(20013), //涉嫌版权 err(22000), //涉嫌互推(互相宣传) err(21000), //涉嫌其他

TotalCount group_id下粉丝数;或者openid_list中的粉丝数
FilterCount 过滤(过滤是指特定地区、性别的过滤、用户设置拒收的过滤,用户接收已超4条的过滤)后,准备发送的粉丝数,原则上,FilterCount = SentCount + ErrorCount
SentCount 发送成功的粉丝数
ErrorCount 发送失败的粉丝数

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

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

<span private</span> <span function</span> receiveEvent(<span $object</span><span )
{
    </span><span $content</span> = ""<span ;
    </span><span switch</span> (<span $object</span>-><span Event)
    {
        </span><span case</span> "subscribe":
            <span $content</span> = "欢迎关注方倍工作室"<span ;
            </span><span break</span><span ;
        </span><span case</span> "MASSSENDJOBFINISH":
            <span $content</span> = "消息ID:".<span $object</span>->MsgID.
                       "\n结果:".<span $object</span>->Status.
                       "\n粉丝数:".<span $object</span>->TotalCount.
                       "\n过滤:".<span $object</span>->FilterCount.
                       "\n发送成功:".<span $object</span>->SentCount.
                       "\n发送失败:".<span $object</span>-><span ErrorCount;
            </span><span break</span><span ;
        </span><span default</span>:
            <span break</span><span ;
    }
    </span><span $result</span> = <span $this</span>->transmitText(<span $object</span>, <span $content</span><span );
    </span><span return</span> <span $result</span><span ;
}</span>
ログイン後にコピー

 

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

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

 

 

ソース:php.cn
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
人気のおすすめ
人気のチュートリアル
詳細>
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート