微信公众平台高级群发接口

出自微信公众平台开发者文档

在公众平台网站上,为订阅号提供了每天一条的群发权限,为服务号提供每月(自然月)4条的群发权限。而对于某些具备开发能力的公众号运营者,可以通过高级群发接口,实现更灵活的群发能力。

请注意:

1、该接口暂时仅提供给已微信认证的服务号
2、高级群发接口的每日调用限制为10次,请小心测试
3、无论在公众平台网站上,还是使用接口群发,用户每月只能接收4条群发消息,多于4条的群发将对该用户发送失败

目录

[隐藏]

  • 1 上传图文消息素材
  • 2 根据分组进行群发
  • 3 根据OpenID列表群发
  • 4 删除群发
  • 5 事件推送群发结果

上传图文消息素材

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN

POST数据说明

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"
		 }
   ]
}
参数 是否必须 说明
Articles 图文消息,一个图文消息支持1到10条图文
thumb_media_id 图文消息缩略图的media_id
author 图文消息的作者
title 图文消息的标题
content_source_url 在图文消息页面点击“阅读原文”后的页面
content 图文消息页面的内容,支持HTML标签
digest 图文消息的描述

返回说明

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

{
   "type":"news",
   "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
   "created_at":1391857799
}
参数 说明
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息
media_id 媒体文件/图文消息上传后获取的唯一标识
created_at 媒体文件上传时间

错误时微信会返回错误码等信息,请根据错误码查询错误信息: 全局返回码说明

根据分组进行群发

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:

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

{
   "filter":{
      "group_id":"2"
   },
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"
}
参数 是否必须 说明
filter 用于设定图文消息的接收者
group_id 群发到的分组的group_id
mpnews 用于设定即将发送的图文消息
media_id 用于群发的消息的media_id
msgtype 群发的消息类型,图文消息为mpnew

返回说明

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

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182
}
参数 说明
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息
errcode 错误码
errmsg 错误信息
msg_id 消息ID

请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待

错误时微信会返回错误码等信息,请根据错误码查询错误信息: 全局返回码说明

根据OpenID列表群发

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:

图文消息:

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"
}
参数 是否必须 说明
touser 填写图文消息的接收者,一串OpenID列表,OpenID最少个,最多10000个
mpnews 用于设定即将发送的图文消息
media_id 用于群发的图文消息的media_id
msgtype 群发的消息类型,图文消息为mpnew

返回说明

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

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182
}
参数 说明
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息
errcode 错误码
errmsg 错误信息
msg_id 消息ID

请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待

错误时微信会返回错误码等信息,请根据错误码查询错误信息: 全局返回码说明

删除群发

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com//cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下:

{
   "msgid":30124
}
参数 是否必须 说明
msg_id 发送出去的消息ID

请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片。

返回说明

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

{
   "errcode":0,
   "errmsg":"ok"
}
参数 说明
errcode 错误码
errmsg 错误信息

错误时微信会返回错误码等信息,请根据错误码查询错误信息: 全局返回码说明

事件推送群发结果

由于群发任务提交后,群发任务可能在一定时间后才完成,因此,群发接口调用时,仅会给出群发任务是否提交成功的提示,若群发任务提交成功,则在群发任务结束时,会向开发者在公众平台填写的开发者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>
参数 说明
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 过滤(过滤是指,有些用户在微信设置不接收该公众号的消息)后,准备发送的粉丝数,原则上,FilterCount = SentCount + ErrorCount
SentCount 发送成功的粉丝数
ErrorCount 发送失败的粉丝数

取自“http://mp.weixin.qq.com/wiki/index.php?title=%E9%AB%98%E7%BA%A7%E7%BE%A4%E5%8F%91%E6%8E%A5%E5%8F%A3

 

 

 

群发接口及四次的解析: 首先,每月4次的群发规则适用所有服务号。其中普通服务号可以通过mp后台(即公众平台后台)群发消息,对于认证服务号的话,除了mp后台外,还可通过新增的群发接口进行个性化的群发,这一条对于第三方产品设计来说是最重要的,下边的深度解读主要针对这个方面。
第二、新增的群发接口,对于“每月4次”的规则的实现是针对接收群发信息的用户来说的,也就是说通过群发接口给某一用户发送消息的话,每月最多是4条,也就是说同一个用户,你每月最多只能推送4条消息给他。而对于该公众账号,每月可群发的次数不只4条。根据现在的接口调用日限额是10条计算,每月至少能发送300条群发信息。一个很常见的应用场景就是,当原来本月的群发信息条数已经发完后,新关注的粉丝,这个月我们就无法给其发送群发消息了,但是现在则不同,我们可以使用群发接口,给新关注粉丝“补发”之前的群发消息,做到每月群发消息100%的覆盖。
第三、群发接口有两种调用方式,一种是提供一个待接收消息的用户openid列表,一种是提供一个待接收消息的用户分组id。第一种使用方式,一般配合“获取关注者列表”接口,通过自己维护的用户业务逻辑分组来使用。第二种方式是使用公众平台系统的分组来使用。这种方式,使得原来很多人忽略的“分组管理接口”变得真正有意义了。
第四、群发任务的任务报告。通过这个接口,可以进行动态监控,了解群发的统计信息,对于第三方开发来说,除了使产品设计更加人性化以外,有一点请大家注意,这个接口是被动调用接口,仅当群发任务完成后,微信才会调用,目前没有办法主动进行状态监控。另外,由于报告只有统计计数,没有具体的openid列表,所以我们没办法直接知道该消息对于某一用户来说是否发送成功。
微信服务号群发接口的开放,大大提升了服务号的功能,同时也给第三方开发公司更大的开发和产品设计空间

 

 

 

概念分析解读:

每天10次调用,是指程序每天调用高级接口中的接口10次,即和https://api.weixin.qq.com/的交互为10次,包括上传素材在内,假如今天上传了10个素材,也算调用了10次,或者上传了5个素材,分别给5个用户发了不同的消息,那么今天也是调用了10次

用户每月4次,是指给同一个用户在一个月之内可以用群发接口发4次消息,假如今天用群发接口给某用户发了4次,那么这个月就再不不能给这个用户发消息了。发了他也收不到

 

如何玩:

 这个东西最好玩的就是给用户分组,今天给这组用户推这个内容,明天给另一组用户推另外的内容,每个内容都和用户关系比较密切,而不是之前的所有人都一样的,最终实现精准推送

 

总结:

 现在就有3种方式来给用户发送消息了,
1. 自动回复,5秒内响应
2. 客服接口回复,48小时内不限次数
3. 高级群发接口,每月4次,但不限时

个人感觉,每个月最好发3条,10天一次左右,留一条以做备用,用于不时不需,另外当月生日的用户,可以用这条给他发生日祝贺(没有比这更精准的更贴心的了吧)。

 

 实现过程,请查看 

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

 

时间: 2024-08-04 09:37:14

微信公众平台高级群发接口的相关文章

关于 微信公众平台高级群发接口的一些问题(.net)

问题描述 .net我试了下这个接口,素材已经成功提交,也返回给了我一个media_id具体的json是{"media_id":"otV-SZTBm0_It6Z0YxekI_4jICHH_gvDWXY2Safj6ggLmVT35PSh52sAkvK_zV6d"}这是已经成功提交素材了,可是我去公众平台素材管理里边去看,并没有我刚才上传的素材,请问提交成功的素材在哪可以看到啊? 解决方案

微信公众平台高级功能

微信公众平台高级功能使用说明文档 一.高级功能介绍 1.1 基本内容介绍 高级功能包括"编辑模式"和"开发模式",两种模式皆可使你所运营的公众帐号个性化,例如具有"自定义菜单"等功能. 1.2 模式互斥性 "编辑模式"和"开发模式"不能同时开启,例如:你已经通过设置"开发模式",成为"开发者",使用微信公众平台提供的接口,若继续设置并使用"编辑模式"

测试-微信公众平台开发多媒体接口下载视频文件如何使用?

问题描述 微信公众平台开发多媒体接口下载视频文件如何使用? 在测试接口上调用该方法返回错误信息 解决方案 http://www.cnblogs.com/txw1958/p/weixin80-upload-download-media-file.html 解决方案二: http://mp.weixin.qq.com/wiki/10/78b15308b053286e2a66b33f0f0f5fb6.html

微信公众平台定时群发功能终于到来了

万众期待的微信公众平台定时群发功能终于来了!就在刚刚,微信团队宣布公众号推送的消息可以定时群发了.官方表示"为了方便公众号运营者更灵活地推送消息,公众平台新增定时群发功能,开放给所有公众号使用."以下是具体的操作方法: 01.群发界面可以选择定时群发 群发界面选中素材后,除了可以直接群发,还可以选择定时群发. 02.设置群发时刻 你可以定时五分钟后的今.明两天内任意时刻群发,成功设置将占用群发时刻当天的一条群发条数.定时消息不支持修改,修改素材库消息也不会改动定时消息的内容. 03.定

第三方平台可以通过微信公众平台素材管理接口实现同步了

平时运营微信公众平台时有没发现素材管理有点不太好操作,特别是素材一多,找个东西都翻半天.现在好了,微信宣布公众平台新增素材管理接口,对所有认证公众号开放,方便快捷,可以实现同步互通.(4.29更新第三方平台也能为未微信认证的订阅号调用自定义菜单接口和素材管理接口) 微信公众平台素材管理接口具体如下: 新增临时素材 公众号经常有需要用到一些临时性的多媒体素材的场景,例如在使用接口特别是发送消息时,对多媒体文件.多媒体消息的获取和调用等操作,是通过media_id来进行的.素材管理接口对所有认证的订

微信公众平台语义理解接口正式对外开放

siri是个不错的应用,对着手机说话就可以帮你设置闹钟找酒店等,现在微信也开始实现这些类似的功能了,微信公众平台语义理解接口正式对外开放. 微信公众平台新增语义理解接口 微信公众平台语义理解接口正式对外开放.通过语义接口,接收用户发送的自然语言请求,让系统理解用户的说话内容. 微信语义理解接口提供从用户自然语言输入到结构化解析的技术实现,使用先进的自然语言处理技术给开发者提供一站式的语义解析方案.该平台覆盖多个垂直领域的语义场景,部分领域还可以支持取得最终的展示结果.开发者无需掌握语义理解及相关

云微客微信公众平台高级接口系列功能率先推出

中介交易 SEO诊断 淘宝客 云主机 技术大厅 继上次云微客版本的更新,用户界面和功能都获得阶段性的飞跃,这少不了全国各地的代理商和准代理提出的宝贵意见.当中最受大家关注的,无疑是针对已认证服务号微信早前公布的五大接口功能,3721.html">2014年5月3日,云微客结合五大接口功能正式上线,大大丰富了商家在微信营销过程中的各项需求.以下让我们来介绍这次更新的内容: 1.数据魔方 数据魔方,全方位提供客户行为分析数据,帮助商家更精准掌握客户行为,对微信营销策划及效果评估作出实质数据支持

微信公众平台(测试接口)准备工作_java

1.申请微信公众号 我们要进行微信公众平台的开发,第一步当然是要有公众号了.什么?不知道什么是微信公众号,看来你还要先回炉炼炼了,呵呵.通俗的说,我们微信平台就好像是一个大社会,里面有个体人,也有各种组织机构.你自己使用的普通微信号就是个体人,而公众号就是那些组织,这些组织又分为2类:一类是提供各种信息的,称为订阅号:另一种是提供各种服务的,称为服务号.当然,目前个人只能申请到订阅号,只有组织机构,比如公司等才能申请到服务号. 订阅号和服务号的区别在哪里呢?简单的说,服务号旨在为用户提供服务.你

php微信公众平台交互与接口详解_php实例

本文分为三大部分为大家进行介绍,具体内容如下 1.微信用户.微信服务器和后台服务器的交互 例:微信用户向公众号发送一条文本消息,这条消息会首先传给微信服务器,微信服务器处理这条信息并将其以xml数据格式传递给后台服务器,后台服务器接受到数据后会对数据进行处理,再响应数据以xml数据格式传递给微信服务器,微信服务器再响应到用户微信界面. 微信用户与微信后台服务器之间的交互过程就是数据传递过程,只不过需要需要通过微信服务器这个中转站. 那么微信服务器这个中转站到底有什么用? 对xml数据进行加工包装