原创:【微信小程序】客服消息教程(后台以PHP示例)

时间:2024-02-16 09:26:37

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&timestamp=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的数据处理,逻辑参照上面。