微信公众号之（素材上传）群发消息
2017-08-25 本文已影响596人
韩寅嵩
微信公众号之（素材上传）群发消息
利用工作之余写写博客，看看博客是个学习的好方法哦！
[TOC]
第一步上传图片（视频、音频等）
公众号经常有需要用到一些临时性的多媒体素材的场景，例如在使用接口特别是发送消息时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口，公众号可以新增临时素材（即上传临时多媒体文件）。
注意点：
1、临时素材media_id是可复用的。
2、媒体文件在微信后台保存时间为3天，即3天后media_id失效。
3、上传临时素材的格式、大小限制与公众平台官网一致。
图片（image）: 2M，支持PNG\JPEG\JPG\GIF格式
语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式
视频（video）：10MB，支持MP4格式
缩略图（thumb）：64KB，支持JPG格式
4、需使用https调用本接口。
接口调用请求说明
http请求方式：POST/FORM，使用https
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE调用示例（使用curl命令用FORM表单方式上传一个多媒体文件）：curl
-F media=@test.jpg "https://api.weixin.qq.com/cgibin/media/uploadaccess_token=ACCESS_TOKEN&type=TYPE"
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| type | 是 | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb） |
| media | 是 | form-data中媒体文件标识，有filename、filelength、content-type等信息 |
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| type | 是 | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb） |
| media | 是 | form-data中媒体文件标识，有filename、filelength、content-type等信息 |
返回说明
正确情况下的返回JSON数据包结果如下：
{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
上传图片分两种一种是封面图片，一种是内容里的图片他们的接口不同这里就不一一举例了，思路都一样；
| 参数 | 描述 |
|---|---|
| type | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb，主要用于视频与音乐格式的缩略图） |
| media_id | 媒体文件上传后，获取标识 |
| created_at | 媒体文件上传时间戳 |
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误！）；
{"errcode":40004,"errmsg":"invalid media type"}
第二步上传图文素材
上传图文消息素材【订阅号与服务号认证后均可用】
接口调用请求说明
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",
"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 | 否 | 图文消息的描述，如本字段为空，则默认抓取正文前64个字 |
| 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 | 媒体文件上传时间 |
错误时微信会返回错误码等信息，请根据错误码查询错误信息
有错误时不要盲目的去百度，去谷歌！~那样只能浪费你宝贵的时间，先通过微信返回的错误信息去排查问题；
第三步进行群发
说明：群分两种，一种是通过用户的openid去发送，一种是向所有用户发送，这里我们只写后者，代码会贴在最后；
接口调用请求说明
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
POST数据说明
POST数据示例如下：
图文消息（注意图文消息的media_id需要通过上述方法来得到）：
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpnews":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"mpnews",
"send_ignore_reprint":0
}
文本：
{
"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需通过基础支持中的上传下载多媒体文件来得到）：
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"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），即可进行发送
{
"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_id |
| mpnews | 是 | 用于设定即将发送的图文消息 |
| media_id | 是 | 用于群发的消息的media_id |
| msgtype | 是 | 群发的消息类型，图文消息为mpnews，文本消息为text，语音为voice，音乐为music，图片为image，视频为video，卡券为wxcard |
| title | 否 | 消息的标题 |
| description | 否 | 消息的描述 |
| thumb_media_id | 是 | 视频缩略图的媒体ID |
| send_ignore_reprint | 是 | 图文消息被判定为转载时，是否继续群发。1为继续群发（转载），0为停止群发。该参数默认为0。 |
返回说明
返回数据示例（正确时的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 | 消息发送任务的ID |
| msg_data_id | 消息的数据ID，该字段只有在群发图文消息时，才会出现。可以用于在图文分析数据接口中，获取到对应的图文消息的数据，是图文分析数据接口中的msgid字段中的前半部分，详见图文分析数据接口中的msgid字段的介绍。 |
请注意：在返回成功时，意味着群发任务提交成功，并不意味着此时群发已经结束，所以，仍有可能在后续的发送过程中出现异常情况导致用户未收到消息，如消息有时会进行审核、服务器不稳定等。此外，群发任务一般需要较长的时间才能全部发送完毕，请耐心等待。
错误时微信会返回错误码等信息，请根据错误码查询错误信息
代码只作为参考
public function send($id=false){
//Gl8DWQUSQHXlB7IBKXcyqF79PSS9Mm_rTvwJsIHx_rPs3oMgWR8tB6l5Z4CNStXo
$id = $id;//I('post.id');
$data = M('news')->where(array('id'=>$id))->select();
$access_token = $this->_getAccessToken();
dump($access_token);
foreach( $data as $k=>$v){
//调用基础支持的上传多媒体文件
$url="https://api.weixin.qq.com/cgi-bin/media/upload?access_token={$access_token}&type=image";
// $url="http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token={$access_token}&type=image";
$arr = array('media'=>'@./Public/Admin/Uploads/Dynamic/'.$v['cover']);
$res = $this->http_curl($url,'post','',$arr);
if( !$res ){
// $this->ajaxReturn( array( 'code'=>1,'msg'=>'id为'.$v['id'].'的数据标题图图片上传失败！' ) );
echo '的数据标题图图片上传失败！';
}
// echo "1111<br />";var_dump($res);echo "<br />";
$v['media_id'] = $res['media_id'];//标题图的thumb_media_id
$v['wxpic'] = $res['url'];
$content = $v['details'];
preg_match_all('/<img.*?src="(.*?)".*?>/is',$content,$arr);//提取所有img的src
$url = "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token={$access_token}&type=image";
//将内容里面的所有img图片上传到微信服务器，并替换新的图片地址
foreach( $arr[1] as $k1=>$vo ){
$arr = array('media'=>'@'.$_SERVER['DOCUMENT_ROOT'].$vo,'form-data'=>$vo);
//调用图片上传到微信服务器接口
$res = $this->http_curl($url,'post','',$arr);
if( !$res['url'] ){
// $this->ajaxReturn( array( 'code'=>1,'msg'=>'id为'.$v['id'].'的消息内容页面的第'.($k1+1).'张图片上传失败！' ) );
//
return 0;
}
$content = str_replace($vo,$res['url'],$content);
}
//拼接数组
$postArr['articles'][] = array(
"thumb_media_id"=>$v['media_id'],
"author"=>urlencode($v['author']),
"title"=>urlencode($v['title']),
"content_source_url"=>urlencode($v['url']),
"content"=>urlencode(htmlspecialchars(str_replace("\"","'",$content))),
"digest"=>urlencode($v['description']),
"show_cover_pic"=>"0"
);
}
//将数组转为json
$postArr = htmlspecialchars_decode(urldecode(json_encode($postArr)));
//调用上传素材接口
$url = 'https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token='.$access_token;
//上传整个素材post
$res = $this->http_curl($url,'post','json',$postArr);
// echo "1111<br />";var_dump($res);echo "<br />";
$media_id = $res['media_id'];//群发素材的media_id
$url= "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token={$access_token}";
// $url= "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=".$access_token;
// $postArr = array(
// "touser"=>"oV3xFwbYr3X4sYFepGUgDNgn6cGg",
// "mpnews"=>[
// "media_id"=>$media_id
// ],
// "msgtype"=>"mpnews"
// );
$postArray['filter']['is_to_all'] = true;
// $postArr['filter'][''] = 2;
$postArray['mpnews']['media_id'] = $media_id;
$postArray['msgtype'] = 'mpnews';
$postArray['send_ignore_reprint'] = 0;
$postArray = json_encode( $postArray );
$res = $this->http_curl($url,'post','json',$postArray);
echo "1111<br />";var_dump($res);
if( $res['errcode']==0 && $res['errmsg'] ){
// $this->MassObj->setField('is_send',1);
// $this->ajaxReturn( array( 'code'=>0,'msg'=>'发送成功！' ) );
return 1;
}else{
// $this->ajaxReturn( array( 'code'=>1,'msg'=>$res['errcode'].':'.$res['errmsg'] ) );
return 0;
}
}
/**
*
*$url 接口url string
*$type 请求类型 string
*$res 返回数据类型 string
*$arr post请求参数 array
*
*/
public function http_curl($url,$type='get',$res='json',$arr=''){
//1.初始化curl
$ch = curl_init();
//2.设置curl的参数
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
if($type == 'post'){
curl_setopt($ch,CURLOPT_POST,1);
curl_setopt($ch,CURLOPT_POSTFIELDS,$arr);
}
//3.采集
$output = curl_exec($ch);
//4.关闭
curl_close($ch);
if($res == 'json'){
if( curl_error($ch) ){
return curl_error($ch);//请求失败返回错误信息
}else{
return json_decode($output,true);//请求成功返回json
}
}else{
if( curl_error($ch) ){
return curl_error($ch);//请求失败返回错误信息
}else{
return json_decode($output,true);//请求成功返回json
}
}
}
