原创:【微信小程序】客服消息教程(后台以PHP示例)
1、不需要自己手动开发客服消息的,直接接入客服,不开启消息推送即可。这种模式不多讲。
2、公众号后台开启消息推送模式,配置服务器URL、TOKEN、随机串、数据模式、数据格式(XML或JSON),这个地方需要注意数据格式,蛮坑哦。;
3、校验服务器配置;
原生php在我的另外一篇文章找找;框架照着原生简单改改就行了,简单参照下面流程:
1)填写服务器配置
2)验证服务器地址的有效性
3)依据接口文档实现业务逻辑
4、重点:重点讲解一下我遇到的数据转换问题吧。微信返回的XML或JSON数据,有时候是根据上面你填写的服务器配置数据格式,比如JSON;有时候则是强制要求你XML,这里我被坑了2天时间。
教训:一定要看题,微信马化腾怎么说,你就怎么干,别胡来更别瞎来。
5、浓缩核心:不废话,直接上代码:
5.1 目的:①实现用户进入客服页面,弹出'您好,有什么能帮助你?'提示语,②实现用户发送文字或图片,客服接入功能
5.2 过程:微信在首次校验你的服务器后,以后每次访问服务器配置URL都会带上校验参数:signature、timestamp、nonce
(特别注意:没有echostr。类似:/index.php/H*******/check_server?signature=1b08b14efea***2bbb2f6949af×tamp=151***967&nonce=18***59)
然后,该POST的数据都不会少,所以看下面
进入会话事件
微信POST过来JSON数据(因为我服务器配置的数据格式是JSON),我们刚才的那个URL要接受并处理这些数据,还要返回东东。
接受数据,最坑了:PHP不能直接接受微信POST过来的数据,所以要是:
<?php namespace Home\Controller; use Think\Controller; header('Content-type:text'); define("TOKEN", "weixin"); class XiaoKeFuController extends Controller { public function index(){ } public function check_server(){ //校验服务器地址URL if (isset($_GET['echostr'])) { $this->valid(); }else{ $this->responseMsg(); } } public function valid() { $echoStr = $_GET["echostr"]; if($this->checkSignature()){ header('content-type:text'); echo $echoStr; exit; }else{ echo $echoStr.'+++'.TOKEN; exit; } } private function checkSignature() { $signature = $_GET["signature"]; $timestamp = $_GET["timestamp"]; $nonce = $_GET["nonce"]; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr, SORT_STRING); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr == $signature ){ return true; }else{ return false; } } public function responseMsg() { $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; if (!empty($postStr) && is_string($postStr)){ //禁止引用外部xml实体 //libxml_disable_entity_loader(true); //$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); $postArr = json_decode($postStr,true); if(!empty($postArr['MsgType']) && $postArr['MsgType'] == 'text'){ //文本消息 $fromUsername = $postArr['FromUserName']; //发送者openid $toUserName = $postArr['ToUserName']; //小程序id $textTpl = array( "ToUserName"=>$fromUsername, "FromUserName"=>$toUserName, "CreateTime"=>time(), "MsgType"=>"transfer_customer_service", ); exit(json_encode($textTpl)); }elseif(!empty($postArr['MsgType']) && $postArr['MsgType'] == 'image'){ //图文消息 $fromUsername = $postArr['FromUserName']; //发送者openid $toUserName = $postArr['ToUserName']; //小程序id $textTpl = array( "ToUserName"=>$fromUsername, "FromUserName"=>$toUserName, "CreateTime"=>time(), "MsgType"=>"transfer_customer_service", ); exit(json_encode($textTpl)); }elseif($postArr['MsgType'] == 'event' && $postArr['Event']=='user_enter_tempsession'){ //进入客服动作 $fromUsername = $postArr['FromUserName']; //发送者openid $content = '您好,有什么能帮助你?'; $data=array( "touser"=>$fromUsername, "msgtype"=>"text", "text"=>array("content"=>$content) ); $json = json_encode($data,JSON_UNESCAPED_UNICODE); //php5.4+ $access_token = $this->get_accessToken(); /* * POST发送https请求客服接口api */ $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=".$access_token; //以'json'格式发送post的https请求 $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, 1); // 发送一个常规的Post请求 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($json)){ curl_setopt($curl, CURLOPT_POSTFIELDS,$json); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); //curl_setopt($curl, CURLOPT_HTTPHEADER, $headers ); $output = curl_exec($curl); if (curl_errno($curl)) { echo 'Errno'.curl_error($curl);//捕抓异常 } curl_close($curl); if($output == 0){ echo 'success';exit; } }else{ exit('aaa'); } }else{ echo ""; exit; } } /* 调用微信api,获取access_token,有效期7200s -xzz0704 */ public function get_accessToken(){ /* 在有效期,直接返回access_token */ if(S('access_token')){ return S('access_token'); } /* 不在有效期,重新发送请求,获取access_token */ else{ $url = 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wx6056****&secret=30e46f3ef07b****'; $result = curl_get_https($url); $res = json_decode($result,true); //json字符串转数组 if($res){ S('access_token',$res['access_token'],7100); return S('access_token'); }else{ return 'api return error'; } } } }
那要是接受的XML数据,咋办呢? 那就更简单了撒
这里只有XML的数据处理,逻辑参照上面。