前期工作
調用微信公眾號接口前,請先熟悉微信公眾平臺開(kāi)發(fā)的前期準備工作與接口調用模式,具體詳情請參考:
https://mp.weixin.qq.com/wiki
1、群發(fā)預覽接口
群發(fā)消息前,可以使用預覽接口進(jìn)行群發(fā)預覽,群發(fā)預覽只會(huì )發(fā)送至指定微信用戶(hù)的微信上(已關(guān)注),群發(fā)的內容只能短暫性有效,逾期將失效。
調用方法
weixin::wx_material_preview()
相關(guān)參數
共3個(gè)必要參數,3個(gè)可選參數,具體如下:
1、群發(fā)的消息類(lèi)型,圖文消息為mpnews,文本消息為text,語(yǔ)音為voice,音樂(lè )為music,圖片為image,視頻為mpvideo,卡券為wxcard,必選
2、用于群發(fā)的消息的騰訊素材id,必選
3、預覽的者微信號/QQ號/手機號,必選
4、圖文消息被判定為轉載時(shí),是否繼續群發(fā)。 1為繼續群發(fā)(轉載),0為停止群發(fā)。 該參數默認為0,可選
5、消息的標題,可選
6、消息的描述,可選
調用實(shí)例
$result = weixin::wx_material_preview('mpnews','abc','wxkyger');
返回結果
錯誤碼:$result['errcode']
錯誤信息:$result['errmsg']
消息ID:$result['msg_id']
2、根據標簽進(jìn)行群發(fā)
調用方法
weixin::wx_material_send_by_tagid()
相關(guān)參數
共7個(gè)參數,具體如下:
1、群發(fā)的消息類(lèi)型,圖文消息為mpnews,文本消息為text,語(yǔ)音為voice,音樂(lè )為music,圖片為image,視頻為mpvideo,卡券為wxcard,必選
2、用于群發(fā)的消息的騰訊素材id,必選
3、群發(fā)到的標簽的tag_id,參見(jiàn)用戶(hù)管理中用戶(hù)分組接口,若向所有用戶(hù)群發(fā),可不填寫(xiě)tag_id,必選
4、用于設定是否向全部用戶(hù)發(fā)送,值為true或false,選擇true該消息群發(fā)給所有用戶(hù),選擇false可根據tag_id發(fā)送給指定群組的用戶(hù),可選
5、圖文消息被判定為轉載時(shí),是否繼續群發(fā)。 1為繼續群發(fā)(轉載),0為停止群發(fā)。 該參數默認為0,可選
6、消息的標題,可選
7、消息的描述,可選
調用實(shí)例
1、群發(fā)給帶”tag_guangdong“標簽的粉絲
$result = weixin::wx_material_send_by_tagid('mpnews','abc','tag_guangdong');
2、群發(fā)給所有粉絲
$result = weixin::wx_material_send_by_tagid('mpnews','abc','',true);
返回結果
錯誤碼:$result['errcode']
錯誤信息:$result['errmsg']
媒體文件類(lèi)型:$result['type'] 圖片(image)、語(yǔ)音(voice)、視頻(video)和縮略圖(thumb),圖文消息為news
消息發(fā)送任務(wù)的ID:$result['msg_id']
消息的數據ID:$result['msg_data_id'] 該字段只有在群發(fā)圖文消息時(shí),才會(huì )出現??梢杂糜谠趫D文分析數據接口中,獲取到對應的圖文消息的數據,是圖文分析數據接口中的msgid字段中的前半部分,詳見(jiàn)圖文分析數據接口中的msgid字段的介紹
3、根據OpenID列表群發(fā)
調用方法
weixin::wx_material_send_by_openid()
相關(guān)參數
共3個(gè)必要參數,3個(gè)可選參數,具體如下:
1、群發(fā)的消息類(lèi)型,圖文消息為mpnews,文本消息為text,語(yǔ)音為voice,音樂(lè )為music,圖片為image,視頻為mpvideo,卡券為wxcard,必選
2、用于群發(fā)的消息的騰訊素材id,必選
3、填寫(xiě)圖文消息的接收者,OpenID數組,OpenID最少2個(gè),最多10000個(gè),必選
4、圖文消息被判定為轉載時(shí),是否繼續群發(fā)。 1為繼續群發(fā)(轉載),0為停止群發(fā)。 該參數默認為0,可選
5、消息的標題,可選
6、消息的描述,可選
調用實(shí)例
$openid = array('abc','def','ghi'); $result = weixin::wx_material_send_by_openid('mpnews','mediakyger',$openid);
返回結果
錯誤碼:$result['errcode']
錯誤信息:$result['errmsg']
媒體文件類(lèi)型:$result['type'] 圖片(image)、語(yǔ)音(voice)、視頻(video)和縮略圖(thumb),圖文消息為news
消息發(fā)送任務(wù)的ID:$result['msg_id']
消息的數據ID:$result['msg_data_id'] 該字段只有在群發(fā)圖文消息時(shí),才會(huì )出現??梢杂糜谠趫D文分析數據接口中,獲取到對應的圖文消息的數據,是圖文分析數據接口中的msgid字段中的前半部分,詳見(jiàn)圖文分析數據接口中的msgid字段的介紹
4、刪除群發(fā)
調用方法
weixin::wx_material_send_del()
相關(guān)參數
共2個(gè)參數,具體如下:
1、群發(fā)任務(wù)id
2、要刪除的文章在圖文消息中的位置,第一篇編號為1,該字段不填或填0會(huì )刪除全部文章
調用實(shí)例
1、刪除群發(fā)任務(wù)id為“task_demo”的所有內容
$result = weixin::wx_material_send_del('task_demo');
2、刪除群發(fā)任務(wù)id為“task_demo1”的第二篇圖文
weixin::wx_material_send_del('task_demo1',2);
返回結果
錯誤碼:$result['errcode']
錯誤信息:$result['errmsg']
5、開(kāi)啟已群發(fā)文章的評論功能
調用方法
weixin::wx_material_open_comment()
相關(guān)參數
共2個(gè)參數,具體如下:
1、群發(fā)任務(wù)id
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,不填寫(xiě)默認操作該任務(wù)中的第一篇圖文
調用實(shí)例
1、刪除群發(fā)任務(wù)id為“task_demo”的所有內容
$result = weixin::wx_material_open_comment('task_demo'); // 方法返回一維數組,結構為微信接口返回的JSON結構 if($result['errcode'] == 0){ echo '發(fā)送成功'; }else{ echo $result['errmsg']; }
2、刪除群發(fā)任務(wù)id為“task_demo1”的第二篇圖文
weixin::wx_material_send_del('task_demo1',1);
6、設置評論精選
調用方法
weixin::set_comment_good()
相關(guān)參數
共4個(gè)參數,具體如下:
1、群發(fā)返回的msg_data_id
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,默認操作第一篇圖文
3、用戶(hù)評論id
4、操作,0.取消精選 1.設置精選
調用實(shí)例
1、設置“task_demo”任務(wù)下,第一篇圖文內的評論“1”為精選
$result = weixin::set_comment_good('task_demo',0,'1',1); // 方法返回一維數組,結構為微信接口返回的JSON結構 if($result['errcode'] == 0){ echo '發(fā)送成功'; }else{ echo $result['errmsg']; }
2、取消“task_demo2”任務(wù)下,第二篇圖文內的評論“2”的精選
$result = weixin::set_comment_good('task_demo2',1,'2',0);
6、回復評論
調用方法
weixin::set_comment_reply()
相關(guān)參數
共5個(gè)參數,具體如下:
1、群發(fā)返回的msg_data_id
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,默認操作第一篇圖文
3、用戶(hù)評論id
4、回復內容,只有設置回復時(shí)必填
5、操作,0.刪除回復 1.設置回復信息
調用實(shí)例
1、回復“task_demo”任務(wù)下,第一篇圖文內的評論為“1”的評論
$result = weixin::set_comment_reply('task_demo',0,'1','此處回復內容',1); // 方法返回一維數組,結構為微信接口返回的JSON結構 if($result['errcode'] == 0){ echo '發(fā)送成功'; }else{ echo $result['errmsg']; }
2、刪除“task_demo2”任務(wù)下,第二篇圖文內評論為“2”的回復
$result =weixin:: set_comment_reply('task_demo2',1,'2','',0);
7、刪除評論
調用方法
weixin::del_comment()
相關(guān)參數
共3個(gè)參數,具體如下:
1、群發(fā)返回的msg_data_id
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,默認操作第一篇圖文
3、用戶(hù)評論id
調用實(shí)例
$result = weixin::del_comment('task_demo','1','1'); // 方法返回一維數組,結構為微信接口返回的JSON結構 if($result['errcode'] == 0){ echo '發(fā)送成功'; }else{ echo $result['errmsg']; }
8、查詢(xún)群發(fā)消息發(fā)送狀態(tài)(訂閱號與服務(wù)號認證后均可用)
調用方法
weixin::get_job_status()
相關(guān)參數
共1個(gè)參數,具體如下:
1、群發(fā)返回的msg_id
調用實(shí)例
$result = weixin::get_job_status('task_demo');
返回結果
群發(fā)消息后返回的消息id:$result['msg_id']
消息發(fā)送后的狀態(tài):$result['msg_status'] SEND_SUCCESS表示發(fā)送成功,SENDING表示發(fā)送中,SEND_FAIL表示發(fā)送失敗,DELETE表示已刪除
9、查看指定文章的評論數據
調用方法
weixin::get_wx_comment()
相關(guān)參數
共1個(gè)必選參數,4個(gè)可選參數,具體如下:
1、群發(fā)返回的msg_data_id,必選
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,默認操作第一篇圖文,可選
3、起始位置,可選
4、獲取數目(>=50會(huì )被拒絕),可選
5、普通評論&精選評論,1 普通評論 2 精選評論,可選
調用實(shí)例
1、獲取前10條評論
$result = weixin::get_wx_comment('task_demo',0,0,10);
2、獲取10-20條評論
$result = weixin::get_wx_comment('task_demo',0,10,10);
返回結果
錯誤碼:$result['errcode']
錯誤信息:$result['errmsg']
總數:$result['total']
用戶(hù)評論id:$result['comment'][0]['user_comment_id']
粉絲openid:$result['comment'][0]['aroundopenid']
評論時(shí)間:$result['comment'][0]['aroundcreate_time']
評論內容:$result['comment'][0]['aroundcontent']
是否精選評論:$result['comment'][0]['aroundcomment_type'] 0為即非精選,1為true,即精選
作者回復內容:$result['comment'][0]['reply']['content']
作者回復時(shí)間:$result['comment'][0]['reply']['create_time']
10、關(guān)閉已群發(fā)文章的評論功能
調用方法
weixin::wx_material_close_comment()
相關(guān)參數
共2個(gè)參數,具體如下:
1、群發(fā)任務(wù)id
2、多圖文時(shí),用來(lái)指定第幾篇圖文,從0開(kāi)始,不填寫(xiě)默認操作該任務(wù)中的第一篇圖文
調用實(shí)例
$result = weixin::wx_material_close_comment('task_demo'); // 方法返回一維數組,結構為微信接口返回的JSON結構 if($result['errcode'] == 0){ echo '發(fā)送成功'; }else{ echo $result['errmsg']; }