前期工作
調用微信公眾號接口前,請先熟悉微信公眾平臺開(kāi)發(fā)的前期準備工作與接口調用模式,具體詳情請參考:
https://mp.weixin.qq.com/wiki
1、添加客服帳號
調用方法
weixin::wx_cs_add()
相關(guān)參數
共2個(gè)必選參數,具體如下:
1、完整客服帳號,格式為:帳號前綴@公眾號微信號,帳號前綴最多10個(gè)字符,必須是英文、數字字符或者下劃線(xiàn),后綴為公眾號微信號,長(cháng)度不超過(guò)30個(gè)字符
2、客服昵稱(chēng),最長(cháng)16個(gè)字
調用實(shí)例
weixin::wx_cs_add('cs1@kyger','客服一號');
2、刪除客服帳號
調用方法
weixin::wx_cs_del()
相關(guān)參數
共1個(gè)必選參數,具體如下:
1、待刪除的完整客服帳號,格式為:帳號前綴@公眾號微信號,帳號前綴最多10個(gè)字符,必須是英文、數字字符或者下劃線(xiàn),后綴為公眾號微信號,長(cháng)度不超過(guò)30個(gè)字符
調用實(shí)例
weixin::wx_cs_del('cs1@kyger');
3、更新客服帳號
調用方法
weixin::wx_cs_update()
相關(guān)參數
共2個(gè)必選參數,具體如下:
1、完整客服帳號,格式為:帳號前綴@公眾號微信號,帳號前綴最多10個(gè)字符,必須是英文、數字字符或者下劃線(xiàn),后綴為公眾號微信號,長(cháng)度不超過(guò)30個(gè)字符
2、客服昵稱(chēng),最長(cháng)16個(gè)字
調用實(shí)例
weixin::wx_cs_update('cs1@kyger','凱格客服');
4、上傳客服頭像
調用方法
weixin::wx_cs_headimg()
相關(guān)參數
共2個(gè)必選參數,具體如下:
1、完整客服帳號,格式為:帳號前綴@公眾號微信號,帳號前綴最多10個(gè)字符,必須是英文、數字字符或者下劃線(xiàn),后綴為公眾號微信號,長(cháng)度不超過(guò)30個(gè)字符
2、上傳文件物理路徑
調用實(shí)例
weixin::wx_cs_headimg('cs1@kyger','/demo.jpg');
5、邀請綁定客服帳號
調用方法
weixin::wx_cs_headimg()
相關(guān)參數
共2個(gè)必選參數,具體如下:
1、完整客服帳號,格式為:帳號前綴@公眾號微信號,帳號前綴最多10個(gè)字符,必須是英文、數字字符或者下劃線(xiàn),后綴為公眾號微信號,長(cháng)度不超過(guò)30個(gè)字符
2、接收綁定邀請的客服微信號
調用實(shí)例
weixin::wx_cs_headimg('cs1@kyger','kyger1305');
6、轉發(fā)消息至微信客服
當微信用戶(hù)在公眾號發(fā)送消息后,如果需要將該消息轉發(fā)至微信客服,則需要使用weixin::transfer_service()方法將消息轉至騰訊多客服系統。
調用方法
weixin::transfer_service()
相關(guān)參數
共1個(gè)必選參數,具體如下:
1、轉發(fā)到指定客服的客服賬號
調用實(shí)例
weixin::transfer_service('cs1@kyger');
7、獲取客服基本信息
調用方法
weixin::wx_cs_list()
相關(guān)參數
無(wú)
調用實(shí)例
$cs_list = weixin::wx_cs_list();
返回結果
返回一維數組,其中"kf_list"為客服列表,二維數組,其結構為:
$cs_list['kf_list'][0]['kf_account']:完整客服帳號,格式為:帳號前綴@公眾號微信號
$cs_list['kf_list'][0]['kf_headimgurl']:客服頭像
$cs_list['kf_list'][0]['kf_id']:客服編號
$cs_list['kf_list'][0]['kf_nick']:客服昵稱(chēng)
$cs_list['kf_list'][0]['invite_wx']:如果客服帳號尚未綁定微信號,但是已經(jīng)發(fā)起了一個(gè)綁定邀請, 則此處顯示綁定邀請的微信號
$cs_list['kf_list'][0]['invite_expire_time']:如果客服帳號尚未綁定微信號,但是已經(jīng)發(fā)起過(guò)一個(gè)綁定邀請, 邀請的過(guò)期時(shí)間,為unix 時(shí)間戳
$cs_list['kf_list'][0]['invite_status']:邀請的狀態(tài),有等待確認“waiting”,被拒絕“rejected”, 過(guò)期“expired”
8、獲取客服在線(xiàn)狀態(tài)
調用方法
weixin::wx_cs_online()
相關(guān)參數
無(wú)
調用實(shí)例
$cs_status = weixin::wx_cs_online();
返回結果
返回一維數組,其中"kf_online_list"為客服狀態(tài)列表,二維數組,其結構為:
$cs_status['kf_online_list'][0]['kf_account']:完整客服帳號,格式為:帳號前綴@公眾號微信號號
$cs_status['kf_online_list'][0]['status']:客服在線(xiàn)狀態(tài),目前為:1、web 在線(xiàn)
$cs_status['kf_online_list'][0]['kf_id']:客服編號
$cs_status['kf_online_list'][0]['accepted_case']:客服當前正在接待的會(huì )話(huà)數
9、獲取客戶(hù)會(huì )話(huà)狀態(tài)
調用方法
weixin::wx_cs_get_session()
相關(guān)參數
共1個(gè)參數,具體如下:
1、粉絲的openid
調用實(shí)例
$cs_session = weixin::wx_cs_get_session('abc');
返回結果
返回一維數組,其中"kf_online_list"為客服狀態(tài)列表,二維數組,其結構為:
$cs_session['kf_online_list'][0]['createtime']:正在接待的客服,為空表示沒(méi)有人在接待
$cs_session['kf_online_list'][0]['kf_account']:會(huì )話(huà)接入的時(shí)間
10、關(guān)閉會(huì )話(huà)
調用方法
weixin::wx_cs_session_close()
相關(guān)參數
共2個(gè)參數,具體如下:
1、完整客服帳號,格式為:帳號前綴@公眾號微信號
2、粉絲的openid
調用實(shí)例
$result= weixin::wx_cs_session_close('cs1@kyger','abc'); if($result['errcode'] == 0){ echo '關(guān)閉成功'; }else{ echo $result['errmsg']; }