- ·上一篇文章:微信公众号 客服消息
- ·下一篇文章:微信公众号开发 模板消息接口
微信 高级群发接口
上传下载多媒体文件来得到):{ "filter":{ "is_to_all":false, "tag_id":2 }, "image":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"image"}视频请注意,此处视频的media_id需通过POST请求到下述接口特别地得到:https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST数据如下(此处media_id需通过基础支持中的上传下载多媒体文件来得到):{ "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ", "title": "TITLE", "description": "Description"}返回将为{ "type":"video", "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc", "created_at":1398848981}然后,POST下述数据(将media_id改为上一步中得到的media_id),即可进行发送{ "filter":{ "is_to_all":false, "tag_id":2 }, "mpvideo":{ "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc" }, "msgtype":"mpvideo"}卡券消息(注意图文消息的media_id需要通过上述方法来得到):{ "filter":{ "is_to_all":false, "tag_id":"2" }, "wxcard":{ "card_id":"123dsdajkasd231jhksad" }, "msgtype":"wxcard"}参数是否必须说明filter是用于设定图文消息的接收者is_to_all否用于设定是否向全部用户发送,值为true或false,选择true该消息群发给所有用户,选择false可根据tag_id发送给指定群组的用户tag_id否群发到的标签的tag_id,参加用户管理中用户分组接口,若is_to_all值为true,可不填写tag_idmpnews是用于设定即将发送的图文消息media_id是用于群发的消息的media_idmsgtype是群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video,卡券为wxcardtitle否消息的标题description否消息的描述thumb_media_id是视频缩略图的媒体ID返回说明返回数据示例(正确时的JSON返回结果):{ "errcode":0, "errmsg":"send job submission success", "msg_id":34182, "msg_data_id": 206227730}参数说明type媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为newserrcode错误码errmsg错误信息msg_id消息发送任务的IDmsg_data_id消息的数据ID,该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。错误时微信会返回错误码等信息,请根据错误码查询错误信息根据OpenID列表群发【订阅号不可用,服务号认证后可用】接口调用请求说明http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKENPOST数据说明POST数据示例如下:图文消息(注意图文消息的media_id需要通过上述方法来得到):{ "touser":[ "OPENID1", "OPENID2" ], "mpnews":{ "media_id":"123dsdajkasd231jhksad" }, "msgtype":"mpnews"}文本:{ "touser":[ "OPENID1", "OPENID2" ], "msgtype": "text", "text": { "content": "hello from boxer."}}语音:{ "touser":[ "OPENID1", "OPENID2" ], "voice":{ "media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT" }, "msgtype":"voice"}图片:{ "touser":[ "OPENID1", "OPENID2" ], "image":{ "media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat" }, "msgtype":"image"}视频:请注意,此处视频的media_id需通过POST请求到下述接口特别地得到: https://api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST数据如下(此处media_id需通过基础支持中的上传下载多媒体文件来得到):{ "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ", "title": "TITLE", "description": "Description"}返回将为{ "type":"video", "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc", "created_at":1398848981}然后,POST下述数据(将media_id改为上一步中得到的media_id),即可进行发送{ "touser":[ "OPENID1", "OPENID2" ], "mpvideo":{ "media_id":"123dsdajkasd231jhksad", "title":"TITLE", "description":"DESCRIPTION" }, "msgtype":"mpvideo"}卡券:{ "touser":[ "OPENID1", "OPENID2" ], "wxcard": {"card_id":"123dsdajkasd231jhksad"} "msgtype":"wxcard"}参数是否必须说明touser是填写图文消息的接收者,一串OpenID列表,OpenID最少2个,最多10000个mpnews是用于设定即将发送的图文消息media_id是用于群发的图文消息的media_idmsgtype是群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video,卡券为wxcardtitle否消息的标题description否消息的描述thumb_media_id是视频缩略图的媒体ID返回说明返回数据示例(正确时的JSON返回结果):{ "errcode":0, "errmsg":"send job submission success", "msg_id":34182, "msg_data_id": 206227730}参数说明type媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),次数为news,即图文消息errcode错误码errmsg错误信息msg_id消息发送任务的IDmsg_data_id消息的数据ID,,该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。错误时微信会返回错误码等信息,请根据错误码查询错误信息删除群发【订阅号与服务
微信 高级群发接口