• 微信小程序---客服消息接口调用,拿来即用


    如果本文对你有用,请爱心点个赞,提高排名,帮助更多的人。谢谢大家!❤

    如果解决不了,可以在文末进群交流。

    如果对你有帮助的话麻烦点个【推荐】~最好还可以follow一下我的GitHub~感谢观看!

    • 在页面中使用 <button open-type="contact" /> 可以显示进入客服会话按钮。

    • <button open-type="contact" class='contactService' session-from="{{'https://https://mp.weixin.qq.com/debug/wxadoc/introduction/image/x11.png'}}" hover-class="none">联系客服获取二维码</button> 
    • 当用户在客服会话发送消息(或进行某些特定的用户操作引发的事件推送时),微信服务器会将消息(或事件)的数据包(JSON或者XML格式)POST请求开发者填写的URL。开发者收到请求后可以使用发送客服消息接口进行异步回复。

    • 微信服务器在将用户的消息发给小程序的开发者服务器地址(开发设置处配置)后,微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次,如果在调试中,发现用户无法收到响应的消息,可以检查是否消息处理超时。关于重试的消息排重,有msgid的消息推荐使用msgid排重。事件类型消息推荐使用FromUserName + CreateTime 排重。

    • 服务器收到请求必须做出下述回复,这样微信服务器才不会对此作任何处理,并且不会发起重试,否则,将出现严重的错误提示。详见下面说明:

      1、直接回复success(推荐方式)
      2、直接回复空串(指字节长度为0的空字符串,而不是结构体中content字段的内容为空)
      
    • 一旦遇到以下情况,微信都会在小程序会话中,向用户下发系统提示“该小程序客服暂时无法提供服务,请稍后再试”:

      1、开发者在5秒内未回复任何内容
      2、开发者回复了异常数据
      
    • 消息推送配置

    • 填写服务器配置

    • 登录https://mp.weixin.qq.com

      点击设置

       

      消息推送配置

       

      消息推送配置

    • 验证消息的确来自微信服务器

    • 开发者提交信息后,微信服务器将发送GET请求到填写的服务器地址URL上,GET请求携带参数如下表所示:

      点击提交认证的时候,需要调用到如下方法,进行校验,校验通过,代表配置成功
    • //实例化对象
          $vyuanCustom = new vyuanCustomAPI();
          //注意:第一步验证时打开,验证完成之后就可以注释了
          $vyuanCustom->isValid();

    以下,贴上项目中的部分代码,供大家参考,不懂地方可以进入微信技术交流群,如果过期可加我微信:mengyilingjian。

     

    • 详细代码解析

    <?php
        //服务器配置接口地址 
        define("TOKEN", "vyuan");       //定义token
        define("WXPAY_APPID", '***********');     //替换为自己的APPID
        define("WXPAY_APPSECRET", '******************'); //替换为自己的APPSECRET
    
        class vyuanCustomAPI{        
            //用于小程序后台第一步验证返回,验证成功后便可注释
            public function isValid(){
                $echoStr = $_GET["echostr"];
                if ($this->checkSignature()) {
                    echo $echoStr;
                    exit;
                }
            }
            
            //官方提供的验证demo
            public 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 send($data){
                $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=".$this->getAccessToken();
                $data = urldecode(json_encode($data));
                $this->curl_post($url,$data);
            }
            
            //xml数据转数组
            public function xml2Array($contents = NULL, $encoding = 'UTF-8', $get_attributes = 1, $priority = 'tag'){
                if (!$contents){
                    return array();
                }
    
                if (!function_exists('xml_parser_create')){
                    return array ();
                }
    
                $parser = xml_parser_create('');
                xml_parser_set_option($parser, XML_OPTION_TARGET_ENCODING, $encoding);
                xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
                xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
                xml_parse_into_struct($parser, trim($contents), $xml_values);
                xml_parser_free($parser);
                
                if (!$xml_values) return array(); 
                $xml_array = array ();
                $parents = array ();
                $opened_tags = array ();
                $arr = array ();
                $current = & $xml_array;
                $repeated_tag_index = array (); 
                foreach ($xml_values as $data){
                    unset ($attributes, $value);
                    extract($data);
                    $result = array ();
                    $attributes_data = array ();
                    if (isset ($value)){
                        if ($priority == 'tag')
                            $result = trim($value);
                        else
                            $result['value'] = trim($value);
                    }
                    
                    if (isset ($attributes) && $get_attributes) {
                        foreach ($attributes as $attr => $val){
                            if ($priority == 'tag')
                                $attributes_data[$attr] = $val;
                            else
                                $result['attr'][$attr] = $val;
                        }
                    }
    
                    if ($type == "open"){ 
                        $parent[$level -1] = & $current;
                        if (!is_array($current) || (!in_array($tag, array_keys($current)))) {
                            $current[$tag] = $result;
                            if ($attributes_data)
                                $current[$tag . '_attr'] = $attributes_data;
                            $repeated_tag_index[$tag . '_' . $level] = 1;
                            if (isset($tag) && $tag && isset($current[$tag])) {
                                $current = & $current[$tag];
                            }
                        }else{
                            if (isset ($current[$tag][0])){
                                $current[$tag][$repeated_tag_index[$tag . '_' . $level]] = $result;
                                $repeated_tag_index[$tag . '_' . $level]++;
                            }else{ 
                                $current[$tag] = array (
                                    $current[$tag],
                                    $result
                                ); 
                                $repeated_tag_index[$tag . '_' . $level] = 2;
                                if (isset ($current[$tag . '_attr'])){
                                    $current[$tag]['0_attr'] = $current[$tag . '_attr'];
                                    unset ($current[$tag . '_attr']);
                                }
                            }
                            $last_item_index = $repeated_tag_index[$tag . '_' . $level] - 1;
                            $current = & $current[$tag][$last_item_index];
                        }
                    }elseif ($type == "complete"){
                        if (!isset ($current[$tag])){
                            $current[$tag] = $result;
                            $repeated_tag_index[$tag . '_' . $level] = 1;
                            if ($priority == 'tag' && $attributes_data) {
                                $current[$tag . '_attr'] = $attributes_data;
                            }
                        }else{
                            if (isset ($current[$tag][0]) && is_array($current[$tag])) {
                                $current[$tag][$repeated_tag_index[$tag . '_' . $level]] = $result;
                                if ($priority == 'tag' && $get_attributes && $attributes_data) {
                                    $current[$tag][$repeated_tag_index[$tag . '_' . $level] . '_attr'] = $attributes_data;
                                }
                                $repeated_tag_index[$tag . '_' . $level]++;
                            }else{
                                $current[$tag] = array (
                                    $current[$tag],
                                    $result
                                ); 
                                $repeated_tag_index[$tag . '_' . $level] = 1;
                                if ($priority == 'tag' && $get_attributes) {
                                    if (isset ($current[$tag . '_attr']) && is_array($current[$tag])){ 
                                        $current[$tag]['0_attr'] = $current[$tag . '_attr'];
                                        unset ($current[$tag . '_attr']);
                                    }
                                    if ($attributes_data){
                                        $current[$tag][$repeated_tag_index[$tag . '_' . $level] . '_attr'] = $attributes_data;
                                    }
                                }
                                $repeated_tag_index[$tag . '_' . $level]++; 
                            }
                        }
                    }elseif ($type == 'close'){
                        $current = & $parent[$level -1];
                    }
                }
                return ($xml_array);
            }
    
            //获取accesstoken
            public function getAccessToken() {
                $tokenFile = "access_token.txt";
                $data = json_decode(file_get_contents($tokenFile,FILE_USE_INCLUDE_PATH));
                //accesstoken有效期是7200秒,这里用到的文件缓存
                //注意:文件权限问题
                if (!$data->expire_time || $data->expire_time < time()) {
                  
                    $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".WXPAY_APPID."&secret=".WXPAY_APPSECRET;
                    
                    $res =  json_decode(file_get_contents($url));
                    if($res) {
                        $arr = array();
                        $access_token = $res->access_token;
                        $arr['expire_time'] = time() + 7000;
                        $arr['access_token'] = $access_token;
                        $fp = fopen($tokenFile, "w");
                        fwrite($fp, json_encode($arr));
                        fclose($fp);
                    }
                } else {
                    $access_token = $data->access_token;
                }
                
                return $access_token;
            }
    
            //post发送json数据
            public function curl_post($url,$post_data){
                $ch = curl_init();
                curl_setopt($ch, CURLOPT_URL, $url);
                curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
                curl_setopt($ch, CURLOPT_POST, 1);
                curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
                $res = curl_exec($ch);
                
                if(!$res){
                    throw new Exception('发送消息失败:'.curl_error($ch));
                }
                curl_close($ch);
            }  
            
            //进入客服窗口,如果需要主动发起客服消息类型为图片,则需要获取media_id
            public function getMedia_id($imageurl){
                 $foldername = date('Y-m-d',time()); //定义文件夹目录
                 $path = __DIR__.'/static/image/Code/'.$foldername.'/'; //服务器存放目录
                 if(!is_dir($path)){
                     mkdir($path,0777,true);
                 }else{
                     chmod($path,0777);
                 }
    
                 //下载二维码到本地
                 $imageInfo = $this -> getImage($imageurl,$path);
                 $imageurl = $imageInfo['save_path'];
                        
                 $post_url = "https://api.weixin.qq.com/cgi-bin/media/upload?access_token={$this->getAccessToken()}&type=image";
                 $ch = curl_init();
                 curl_setopt($ch, CURLOPT_URL, $post_url);
                 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
                 curl_setopt($ch, CURLOPT_POST, 1);
                 curl_setopt($ch, CURLOPT_POSTFIELDS, ['media'=>'@'.$imageurl]);
                 $res = curl_exec($ch);
                 $a = json_decode($res);
    
                 $media_id = $a->media_id;
                return $media_id;
            }
    
            //下载二维码
            public function getImage($url,$save_dir,$filename='',$type=0){
                if(trim($url)==''){
                    return array('file_name'=>'','save_path'=>'','error'=>1);
                }
                if(trim($filename)==''){//保存文件名
                    $ext=strrchr($url,'.');
                    if($ext!='.gif'&&$ext!='.jpg'){
                        return array('file_name'=>'','save_path'=>'','error'=>3);
                    }
                    $filename=time().$ext;
                }
                //获取远程文件所采用的方法
                if($type){
                    $ch=curl_init();
                    $timeout=5;
                    curl_setopt($ch,CURLOPT_URL,$url);
                    curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
                    curl_setopt($ch,CURLOPT_CONNECTTIMEOUT,$timeout);
                    $img=curl_exec($ch);
                    curl_close($ch);
                }else{
                    ob_start();
                    readfile($url);
                    $img=ob_get_contents();
                    ob_end_clean();
                }
        
                //下载文件
                $fp2=@fopen($save_dir.$filename,'a');
                fwrite($fp2,$img);
                fclose($fp2);
                unset($img,$url);
                return array('file_name'=>$filename,'save_path'=>$save_dir.$filename,'error'=>0);
              }
        };
        
        //实例化对象
        $vyuanCustom = new vyuanCustomAPI();
        //注意:第一步验证时打开,验证完成之后就可以注释了
        $vyuanCustom->isValid();
    
        if($vyuanCustom->checkSignature() === true){
            $xmlstring = file_get_contents("php://input");
            $accept_info = $vyuanCustom->xml2Array($xmlstring)['xml'];
            
            if($accept_info){
                $ToUserName = $accept_info['ToUserName'];
                $FromUserName = $accept_info['FromUserName'];
                $CreateTime = $accept_info['CreateTime'];
                $MsgType = $accept_info['MsgType'];
    
                $data = array();
                if($MsgType == 'text'){//接收文本
                    $Content = $accept_info['Content'];//文本内容
                    $data['touser'] = $FromUserName;
                    
                    if($Content === '图文') {
                        $data['msgtype'] = 'link';
                        $data['link']['title'] = urlencode('文章标题');
                        $data['link']['description'] = urlencode('好文章要分享');
                        $data['link']['url'] = 'https://segmentfault.com';
                        $data['link']['thumb_url'] = 'https://static.segmentfault.com/v-5a7c12fe/global/img/logo-b.svg';
                    }else if($Content === '1'){
                        $data['msgtype'] = 'image';
                        $data['image']['media_id'] = 'q3oQpLPWOIB50tCKdR510qeNIGEQd9A0Ku7DJJmsTsXVeQZqq0sUMK2gbUyJZsYn';
                        $data['image']['picurl'] = 'this is image';
                    }else if($Content === '2'){
                        $data['msgtype'] = 'text';
                        $data['text']['content'] = urlencode('你好');//urlencode 解决中文乱码问题
                        
                    }else{
                        $data['msgtype'] = 'text';
                        $data['text']['content'] = urlencode('对不起,我不知道您在说什么....');//urlencode 解决中文乱码问题
                    }
                    
                    $vyuanCustom->send($data);exit;
                    
                }else if($MsgType === 'image') {//接收图片
                    
    
                }else if($MsgType === 'event') {//进入客服窗口事件
                    $Event = $accept_info['Event'];
                    $SessionFrom = $accept_info['SessionFrom'];  //得到开发者在客服会话按钮设置的session-from属性
    
                    $media_id = $vyuanCustom -> getMedia_id($SessionFrom);
    
                    if($Event == 'user_enter_tempsession') {
                        $data['touser'] = $FromUserName;
    
                        if(!$media_id){
                            //红娘二维码不为空,发送二维码
                            $data['msgtype'] = 'image';
                            $data['image']['media_id'] = $media_id;
                            //$data['image']['media_id'] = 'D6SA5xGFDlrxspT2LovHD2gbMHrUjhcji7B6WUXZ2lG7rhWi4K8ExT0_6FF4uvJY';
                            $data['image']['picurl'] = 'this is image';
                        }else{
                            //红娘二维码为空,则发送文字
                            $data['msgtype'] = 'text';
                            $data['text']['content'] = urlencode('您好,请回复1获取我的微信');//urlencode 解决中文乱码问题
                        }
                        
                        $vyuanCustom->send($data);exit;
                    }
                }
                
                echo '<xml><ToUserName><![CDATA['.$FromUserName.']]></ToUserName><FromUserName><![CDATA['.$ToUserName.']]></FromUserName><CreateTime>'.$CreateTime.'</CreateTime><MsgType><![CDATA[transfer_customer_service]]></MsgType></xml>';
            }
        }
         
  • 相关阅读:
    windows下wamp多域名的配置
    数据库设计
    面向接口编程
    面向对象的设计原则
    javascript设计模式——适配器模式
    javascript设计模式——状态模式
    javascript设计模式——装饰者模式
    javascript设计模式——中介者模式
    javascript设计模式——职责链模式
    javascript设计模式——享元模式
  • 原文地址:https://www.cnblogs.com/mengyilingjian/p/11699860.html
Copyright © 2020-2023  润新知