微信公眾號(hào)之（素材上傳）群發(fā)消息
利用工作之余寫寫博客，看看博客是個(gè)學(xué)習(xí)的好方法哦！
[TOC]
第一步上傳圖片（視頻、音頻等）
公眾號(hào)經(jīng)常有需要用到一些臨時(shí)性的多媒體素材的場(chǎng)景，例如在使用接口特別是發(fā)送消息時(shí)，對(duì)多媒體文件、多媒體消息的獲取和調(diào)用等操作，是通過media_id來(lái)進(jìn)行的。素材管理接口對(duì)所有認(rèn)證的訂閱號(hào)和服務(wù)號(hào)開放。通過本接口，公眾號(hào)可以新增臨時(shí)素材（即上傳臨時(shí)多媒體文件）。
注意點(diǎn)：
1、臨時(shí)素材media_id是可復(fù)用的。
2、媒體文件在微信后臺(tái)保存時(shí)間為3天，即3天后media_id失效。
3、上傳臨時(shí)素材的格式、大小限制與公眾平臺(tái)官網(wǎng)一致。
圖片（image）: 2M，支持PNG\JPEG\JPG\GIF格式
語(yǔ)音（voice）：2M，播放長(zhǎng)度不超過60s，支持AMR\MP3格式
視頻（video）：10MB，支持MP4格式
縮略圖（thumb）：64KB，支持JPG格式
4、需使用https調(diào)用本接口。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式：POST/FORM，使用https
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE調(diào)用示例（使用curl命令用FORM表單方式上傳一個(gè)多媒體文件）：curl
-F media=@test.jpg "https://api.weixin.qq.com/cgibin/media/uploadaccess_token=ACCESS_TOKEN&type=TYPE"
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| type | 是 | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb） |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| type | 是 | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb） |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
返回說明
正確情況下的返回JSON數(shù)據(jù)包結(jié)果如下：
{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
上傳圖片分兩種一種是封面圖片，一種是內(nèi)容里的圖片他們的接口不同這里就不一一舉例了，思路都一樣；
| 參數(shù) | 描述 |
|---|---|
| type | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb，主要用于視頻與音樂格式的縮略圖） |
| media_id | 媒體文件上傳后，獲取標(biāo)識(shí) |
| created_at | 媒體文件上傳時(shí)間戳 |
錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無(wú)效媒體類型錯(cuò)誤！）；
{"errcode":40004,"errmsg":"invalid media type"}
第二步上傳圖文素材
上傳圖文消息素材【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN
POST數(shù)據(jù)說明
POST數(shù)據(jù)示例
{
"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
}
]
}
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| Articles | 是 | 圖文消息，一個(gè)圖文消息支持1到8條圖文 |
| thumb_media_id | 是 | 圖文消息縮略圖的media_id，可以在基礎(chǔ)支持-上傳多媒體文件接口中獲得 |
| author | 否 | 圖文消息的作者 |
| title | 是 | 圖文消息的標(biāo)題 |
| content_source_url | 否 | 在圖文消息頁(yè)面點(diǎn)擊“閱讀原文”后的頁(yè)面，受安全限制，如需跳轉(zhuǎn)Appstore，可以使用itun.es或appsto.re的短鏈服務(wù)，并在短鏈后增加 #wechat_redirect 后綴。 |
| content | 是 | 圖文消息頁(yè)面的內(nèi)容，支持HTML標(biāo)簽。具備微信支付權(quán)限的公眾號(hào)，可以使用a標(biāo)簽，其他公眾號(hào)不能使用，如需插入小程序卡片，可參考下文。 |
| digest | 否 | 圖文消息的描述，如本字段為空，則默認(rèn)抓取正文前64個(gè)字 |
| show_cover_pic | 否 | 是否顯示封面，1為顯示，0為不顯示 |
返回說明
返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)
{
"type":"news",
"media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
"created_at":1391857799
}
| 參數(shù) | 說明 |
|---|---|
| type | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb），圖文消息（news） |
| media_id | 媒體文件/圖文消息上傳后獲取的唯一標(biāo)識(shí) |
| created_at | 媒體文件上傳時(shí)間 |
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息
有錯(cuò)誤時(shí)不要盲目的去百度，去谷歌！~那樣只能浪費(fèi)你寶貴的時(shí)間，先通過微信返回的錯(cuò)誤信息去排查問題；
第三步進(jìn)行群發(fā)
說明：群分兩種，一種是通過用戶的openid去發(fā)送，一種是向所有用戶發(fā)送，這里我們只寫后者，代碼會(huì)貼在最后；
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
POST數(shù)據(jù)說明
POST數(shù)據(jù)示例如下：
圖文消息（注意圖文消息的media_id需要通過上述方法來(lái)得到）：
{
"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"
}
語(yǔ)音/音頻（注意此處media_id需通過基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"voice":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"voice"
}
圖片（注意此處media_id需通過基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"image":{
"media_id":"123dsdajkasd231jhksad"
},
"msgtype":"image"
}
視頻
請(qǐng)注意，此處視頻的media_id需通過POST請(qǐng)求到下述接口特別地得到：https://api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST數(shù)據(jù)如下（此處media_id需通過基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：
{
"media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
"title": "TITLE",
"description": "Description"
}
返回將為
{
"type":"video",
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
"created_at":1398848981
}
然后，POST下述數(shù)據(jù)（將media_id改為上一步中得到的media_id），即可進(jìn)行發(fā)送
{
"filter":{
"is_to_all":false,
"tag_id":2
},
"mpvideo":{
"media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc"
},
"msgtype":"mpvideo"
}
卡券消息（注意圖文消息的media_id需要通過上述方法來(lái)得到）：
{
"filter":{
"is_to_all":false,
"tag_id":"2"
},
"wxcard":{
"card_id":"123dsdajkasd231jhksad"
},
"msgtype":"wxcard"
}
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| filter | 是 | 用于設(shè)定圖文消息的接收者 |
| is_to_all | 否 | 用于設(shè)定是否向全部用戶發(fā)送，值為true或false，選擇true該消息群發(fā)給所有用戶，選擇false可根據(jù)tag_id發(fā)送給指定群組的用戶 |
| tag_id | 否 | 群發(fā)到的標(biāo)簽的tag_id，參加用戶管理中用戶分組接口，若is_to_all值為true，可不填寫tag_id |
| mpnews | 是 | 用于設(shè)定即將發(fā)送的圖文消息 |
| media_id | 是 | 用于群發(fā)的消息的media_id |
| msgtype | 是 | 群發(fā)的消息類型，圖文消息為mpnews，文本消息為text，語(yǔ)音為voice，音樂為music，圖片為image，視頻為video，卡券為wxcard |
| title | 否 | 消息的標(biāo)題 |
| description | 否 | 消息的描述 |
| thumb_media_id | 是 | 視頻縮略圖的媒體ID |
| send_ignore_reprint | 是 | 圖文消息被判定為轉(zhuǎn)載時(shí)，是否繼續(xù)群發(fā)。1為繼續(xù)群發(fā)（轉(zhuǎn)載），0為停止群發(fā)。該參數(shù)默認(rèn)為0。 |
返回說明
返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：
{
"errcode":0,
"errmsg":"send job submission success",
"msg_id":34182,
"msg_data_id": 206227730
}
| 參數(shù) | 說明 |
|---|---|
| type | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb），圖文消息為news |
| errcode | 錯(cuò)誤碼 |
| errmsg | 錯(cuò)誤信息 |
| msg_id | 消息發(fā)送任務(wù)的ID |
| msg_data_id | 消息的數(shù)據(jù)ID，該字段只有在群發(fā)圖文消息時(shí)，才會(huì)出現(xiàn)。可以用于在圖文分析數(shù)據(jù)接口中，獲取到對(duì)應(yīng)的圖文消息的數(shù)據(jù)，是圖文分析數(shù)據(jù)接口中的msgid字段中的前半部分，詳見圖文分析數(shù)據(jù)接口中的msgid字段的介紹。 |
請(qǐng)注意：在返回成功時(shí)，意味著群發(fā)任務(wù)提交成功，并不意味著此時(shí)群發(fā)已經(jīng)結(jié)束，所以，仍有可能在后續(xù)的發(fā)送過程中出現(xiàn)異常情況導(dǎo)致用戶未收到消息，如消息有時(shí)會(huì)進(jìn)行審核、服務(wù)器不穩(wěn)定等。此外，群發(fā)任務(wù)一般需要較長(zhǎng)的時(shí)間才能全部發(fā)送完畢，請(qǐng)耐心等待。
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息
代碼只作為參考
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){
//調(diào)用基礎(chǔ)支持的上傳多媒體文件
$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'].'的數(shù)據(jù)標(biāo)題圖圖片上傳失敗！' ) );
echo '的數(shù)據(jù)標(biāo)題圖圖片上傳失敗！';
}
// echo "1111<br />";var_dump($res);echo "<br />";
$v['media_id'] = $res['media_id'];//標(biāo)題圖的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";
//將內(nèi)容里面的所有img圖片上傳到微信服務(wù)器，并替換新的圖片地址
foreach( $arr[1] as $k1=>$vo ){
$arr = array('media'=>'@'.$_SERVER['DOCUMENT_ROOT'].$vo,'form-data'=>$vo);
//調(diào)用圖片上傳到微信服務(wù)器接口
$res = $this->http_curl($url,'post','',$arr);
if( !$res['url'] ){
// $this->ajaxReturn( array( 'code'=>1,'msg'=>'id為'.$v['id'].'的消息內(nèi)容頁(yè)面的第'.($k1+1).'張圖片上傳失敗！' ) );
//
return 0;
}
$content = str_replace($vo,$res['url'],$content);
}
//拼接數(shù)組
$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"
);
}
//將數(shù)組轉(zhuǎn)為json
$postArr = htmlspecialchars_decode(urldecode(json_encode($postArr)));
//調(diào)用上傳素材接口
$url = 'https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token='.$access_token;
//上傳整個(gè)素材post
$res = $this->http_curl($url,'post','json',$postArr);
// echo "1111<br />";var_dump($res);echo "<br />";
$media_id = $res['media_id'];//群發(fā)素材的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'=>'發(fā)送成功！' ) );
return 1;
}else{
// $this->ajaxReturn( array( 'code'=>1,'msg'=>$res['errcode'].':'.$res['errmsg'] ) );
return 0;
}
}
/**
*
*$url 接口url string
*$type 請(qǐng)求類型 string
*$res 返回?cái)?shù)據(jù)類型 string
*$arr post請(qǐng)求參數(shù) array
*
*/
public function http_curl($url,$type='get',$res='json',$arr=''){
//1.初始化curl
$ch = curl_init();
//2.設(shè)置curl的參數(shù)
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.關(guān)閉
curl_close($ch);
if($res == 'json'){
if( curl_error($ch) ){
return curl_error($ch);//請(qǐng)求失敗返回錯(cuò)誤信息
}else{
return json_decode($output,true);//請(qǐng)求成功返回json
}
}else{
if( curl_error($ch) ){
return curl_error($ch);//請(qǐng)求失敗返回錯(cuò)誤信息
}else{
return json_decode($output,true);//請(qǐng)求成功返回json
}
}
}
