微信 高级群发接口

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-26 高级群发接口在公众平台网站上，为订阅号提供了每天一条的群发权限，为服务号提供每月（自然月）4条的群发权限。而对于某些具备开发能力的公众号运营者，可以通过高级群发接口，实现更灵活的群发能力。请注意：1、对于认证订阅号，群发接口每天可成功调用1次，此次群发可选择发送给全部用户或某个标签；2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败；3、具备微信支付权限的公众号，在使用群发接口上传、群发图文消息类型时，可使用<a>标签加入外链；4、开发者可以使用预览接口校对消息样式和排版，通过预览接口可发送编辑好的消息给指定用户校验效果。群发图文消息的过程如下：1、首先，预先将图文消息中需要用到的图片，使用上传图文消息内图片接口，上传成功并获得图片URL2、上传图文消息素材，需要用到图片时，请使用上一步获取的图片URL3、使用对用户标签的群发，或对OpenID列表的群发，将图文消息群发出去4、在上述过程中，如果需要，还可以预览图文消息、查询群发状态，或删除已群发的消息等群发图片、文本等其他消息类型的过程如下：1、如果是群发文本消息，则直接根据下面的接口说明进行群发即可2、如果是群发图片、视频等消息，则需要预先通过素材管理接口准备好mediaID关于群发时使用is_to_all为true使其进入公众号在微信客户端的历史消息列表：1、使用is_to_all为true且成功群发，会使得此次群发进入历史消息列表。2、为防止异常，认证订阅号在一天内，只能使用is_to_all为true进行群发一次，或者在公众平台官网群发（不管本次群发是对全体还是对某个分组）一次。以避免一天内有2条群发进入历史消息列表。3、类似地，服务号在一个月内，使用is_to_all为true群发的次数，加上公众平台官网群发（不管本次群发是对全体还是对某个分组）的次数，最多只能是4次。4、设置is_to_all为false时是可以多次群发的，但每个用户只会收到最多4条，且这些群发不会进入历史消息列表。另外，请开发者注意，本接口中所有使用到media_id的地方，现在都可以使用素材管理中的永久素材media_id了。请但注意，使用同一个素材群发出去的链接是一样的，这意味着，删除某一次群发，会导致整个链接失效。上传图文消息内的图片获取URL【订阅号与服务号认证后均可用】请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下。接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN调用示例（使用curl命令，用FORM表单方式上传一个图片）：curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"参数说明参数是否必须说明access_token是调用接口凭证media是form-data中媒体文件标识，有filename、filelength、content-type等信息返回说明 正常情况下的返回结果为：{    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"}其中url就是上传图片的URL，可用于后续群发中，放置到图文消息中。错误时微信会返回错误码等信息，请根据错误码查询错误信息上传图文消息素材【订阅号与服务号认证后均可用】接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKENPOST数据说明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",                        "show_cover_pic":1 }, {                        "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",                        "show_cover_pic":0 }   ]}参数是否必须说明Articles是图文消息，一个图文消息支持1到8条图文thumb_media_id是图文消息缩略图的media_id，可以在基础支持-上传多媒体文件接口中获得author否图文消息的作者title是图文消息的标题content_source_url否在图文消息页面点击“阅读原文”后的页面，受安全限制，如需跳转Appstore，可以使用itun.es或appsto.re的短链服务，并在短链后增加 #wechat_redirect 后缀。content是图文消息页面的内容，支持HTML标签。具备微信支付权限的公众号，可以使用a标签，其他公众号不能使用digest否图文消息的描述show_cover_pic否是否显示封面，1为显示，0为不显示返回说明返回数据示例（正确时的JSON返回结果）：{   "type":"news",   "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",   "created_at":1391857799}参数说明type媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb），图文消息（news）media_id媒体文件/图文消息上传后获取的唯一标识created_at媒体文件上传时间错误时微信会返回错误码等信息，请根据错误码查询错误信息根据标签进行群发【订阅号与服务号认证后均可用】接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：图文消息（注意图文消息的media_id需要通过上述方法来得到）：{   "filter":{      "is_to_all":false,      "tag_id":2   },   "mpnews":{      "media_id":"123dsdajkasd231jhksad"   },    "msgtype":"mpnews"}文本：{   "filter":{      "is_to_all":false,      "tag_id":2   },   "text":{      "content":"CONTENT"   },    "msgtype":"text"}语音（注意此处media_id需通过基础支持中的上传下载多媒体文件来得到）：{   "filter":{      "is_to_all":false,      "tag_id":2   },   "voice":{      "media_id":"123dsdajkasd231jhksad"   },    "msgtype":"voice"}图片（注意此处media_id需通过基础支持中的