微信 高级群发接口

号认证后均可用】群发之后，随时可以通过该接口删除群发。接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：{   "msg_id":30124}参数是否必须说明msg_id是发送出去的消息ID请注意：1、只有已经发送成功的消息才能删除2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效返回说明返回数据示例（正确时的JSON返回结果）：{   "errcode":0,   "errmsg":"ok"}参数说明errcode错误码errmsg错误信息错误时微信会返回错误码等信息，请根据错误码查询错误信息预览接口【订阅号与服务号认证后均可用】开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求，在保留对openID预览能力的同时，增加了对指定微信号发送预览的能力，但该能力每日调用次数有限制（100次），请勿滥用。接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：图文消息（其中media_id与根据分组群发中的media_id相同）：{   "touser":"OPENID",    "mpnews":{                          "media_id":"123dsdajkasd231jhksad"                            },   "msgtype":"mpnews" }文本：{         "touser":"OPENID",    "text":{                      "content":"CONTENT"                       },         "msgtype":"text"}语音（其中media_id与根据分组群发中的media_id相同）：{    "touser":"OPENID",    "voice":{                          "media_id":"123dsdajkasd231jhksad"            },    "msgtype":"voice" }图片（其中media_id与根据分组群发中的media_id相同）：{    "touser":"OPENID",    "image":{                  "media_id":"123dsdajkasd231jhksad"            },    "msgtype":"image" }视频（其中media_id与根据分组群发中的media_id相同）：{    "touser":"OPENID",    "mpvideo":{  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",                  },    "msgtype":"mpvideo" }卡券：{ "touser":"OPENID",   "wxcard":{                         "card_id":"123dsdajkasd231jhksad",            "card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}"                           },   "msgtype":"wxcard" }请注意，上述JSON数据中的touser字段都可以改为towxname，这样就可以针对微信号进行预览（而非openID），towxname和touser同时赋值时，以towxname优先。修改后JSON数据如下（以图文消息为例）： 图文消息：{   "towxname":"示例的微信号",    "mpnews":{                          "media_id":"123dsdajkasd231jhksad"                            },   "msgtype":"mpnews" }参数说明touser接收消息用户对应该公众号的openid，该字段也可以改为towxname，以实现对微信号的预览msgtype群发的消息类型，图文消息为mpnews，文本消息为text，语音为voice，音乐为music，图片为image，视频为video，卡券为wxcardmedia_id用于群发的消息的media_idcontent发送文本消息时文本的内容返回说明返回数据示例（正确时的JSON返回结果）：{   "errcode":0,   "errmsg":"preview success",   "msg_id":34182}参数说明errcode错误码errmsg错误信息msg_id消息ID查询群发消息发送状态【订阅号与服务号认证后均可用】接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下：{   "msg_id": "201053012"}参数说明msg_id群发消息后返回的消息id返回说明返回数据示例（正确时的JSON返回结果）：{     "msg_id":201053012,     "msg_status":"SEND_SUCCESS"}参数说明msg_id群发消息后返回的消息idmsg_status消息发送后的状态，SEND_SUCCESS表示发送成功事件推送群发结果由于群发任务提交后，群发任务可能在一定时间后才完成，因此，群发接口调用时，仅会给出群发任务是否提交成功的提示，若群发任务提交成功，则在群发任务结束时，会向开发者在公众平台填写的开发者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公众号群发助手的微信号，为mphelperCreateTime创建时间的时间戳MsgType消息类型，此处为eventEvent事件信息，此处为MASSSENDJOBFINISHMsgID群发的消息IDStatus群发的结构，为“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), //涉嫌其他TotalCounttag_id下粉丝数；或者openid_list中的粉丝数FilterCount过滤（过滤是指特定地区、性别的过滤、用户设置拒收的过滤，用户接收已超4条的过滤）后，准备发送的粉丝数，原则上，FilterCount = SentCount + ErrorCountSentCount发送成功的粉丝数ErrorCount发送失败的粉丝数