微信小程序【客服消息】功能开发-即速应用

最近在开发微信小程序，前后端均是我一个人负责，也着实受了不少苦

网上客服消息开发挺多的，但是大多数说的都不详尽对新人来说有很多坑，最后还是根据官方说明文档一步一步走下来，写一份新人版的供大家参考，望大佬指正

注：如果要参考官方文档的话，这里有一个我推荐的阅读顺序

https://developers.weixin.qq.com/miniprogram/dev/component/contact-button.html?t=20161221

contact-button 按钮介绍，这是入口

https://developers.weixin.qq.com/miniprogram/dev/api/custommsg/receive.html#%E8%BF%9B%E5%85%A5%E4%BC%9A%E8%AF%9D%E4%BA%8B%E4%BB%B6

然后了解用户在客服会话中发送文本消息时产生的数据包结构

https://developers.weixin.qq.com/miniprogram/dev/api/custommsg/conversation.html

最后再看咱们往客户发送客服消息的数据包结构

https://developers.weixin.qq.com/miniprogram/dev/api/custommsg/material.html?t=2018518

如果有图片消息，再看获取素材media_id（注意：微信公众号的media_id和小程序的media_id的获取接口是不同的，我当初就没仔细看坑了我好久）

官方的客服消息分两种

第一种是在小程序内添加contact-button标签，点击后会进入到“小程序客服消息”

第二种是网页版的“客服消息”，在小程序平台里，选择“客服消息”，添加客服人员即可这里就不讲了

网上资料都让大家配“消息推送”，其实“消息推送”就是实现第一种“客服消息”的功能，当你设置好“消息推送”后，你再进入客服消息时，微信后台会自动发送数据包到你设置的url中，咱们获取传过来的数据再做相应处理即可

首先我们要配置“消息推送”，进入小程序平台，选择“设置”->“开发设置”->“消息推送”->点击“启用”

小程序

启用后需要填写url（即你要处理消息回复消息，写逻辑功能的地方，我习惯用php做后台所以服务器地址是http://XXX.php），Token随便写只要和你url对应的php里的token相同即可，最后数据格式就是你希望微信后台向你发送什么格式的数据包，个人比较喜欢json，本文也用json做例子

小程序

配置好后点击提交，token验证成功即可提交成功，下方即为验证Token部分

$signature = $_GET["signature"];$timestamp = $_GET["timestamp"];$nonce = $_GET["nonce"];    $token = TOKEN;  //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;}

提交成功后，恭喜你离成功已经很近了，接下来打开url对应文件

define("TOKEN", "");  //填写自己的tokenif (isset($_GET['echostr'])) {//校验服务器地址URLvalid();}else{responseMsg();}     function valid()    {        $echoStr = $_GET["echostr"];        if(checkSignature()){            header('content-type:text');            echo $echoStr;            exit;        }else{            echo $echoStr.'+++'.TOKEN;            exit;        }    }     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;        }    }     function responseMsg()    {        $postStr = file_get_contents('php://input');   //此处推荐使用file_get_contents('php://input')获取后台post过来的数据        if (!empty($postStr) && is_string($postStr)){$postArr = json_decode($postStr,true);            if(!empty($postArr['MsgType']) && $postArr['MsgType'] == 'text'){   //用户发送文本消息                $fromUsername = $postArr['FromUserName'];   //发送者openid                $media_id = '';   //输入想要回复的图片消息的media_id                $data=array(                    "touser"=>$fromUsername,                    "msgtype"=>"image",                    "image"=>array("media_id"=>$media_id)                );                $json = json_encode($data,JSON_UNESCAPED_UNICODE);  //php5.4+                requestAPI($json);            }elseif(!empty($postArr['MsgType']) && $postArr['MsgType'] == 'image'){ //用户发送图文消息                $fromUsername = $postArr['FromUserName'];   //发送者openid$media_id = '';   //输入想要回复的图片消息的media_id                $data=array(                    "touser"=>$fromUsername,                    "msgtype"=>"image",                    "image"=>array("media_id"=>$media_id)                );                $json = json_encode($data,JSON_UNESCAPED_UNICODE);  //php5.4以上版本才可使用                requestAPI($json);            }elseif($postArr['MsgType'] == 'event' && $postArr['Event']=='user_enter_tempsession'){ //用户进入客服                $fromUsername = $postArr['FromUserName'];   //此处为文字回复，不同的回复方式可参考文章顶部第三个链接“回复客户消息”里查看                $content = '你好,你的专属海报正在制作中,请稍后回复“1”获取海报';                $data=array(                    "touser"=>$fromUsername,                    "msgtype"=>"text",                    "text"=>array("content"=>$content)                );                $json = json_encode($data,JSON_UNESCAPED_UNICODE);  //php5.4+                requestAPI($json);               }else{                exit('error');            }        }else{            echo "empty";            exit;        }    }function requestAPI($json){$access_token = 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;}}    /* 调用微信api，获取access_token，有效期7200s*/    function get_accessToken(){$url = 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wx****&secret='***'; //替换成自己的小程序id和secret@$weixin = file_get_contents($url);@$jsondecode = json_decode($weixin);@$array = get_object_vars($jsondecode);$token = $array['access_token'];return $token;    }

最后进入自己的微信小程序，在需要的地方添加contact-button标签即可

<contact-button           type="default-light"           size="27"                       session-from="weapp"></contact-button><!--  size值18~27 session-from携带参数 -->

这里强调一下，在更改后台代码后一定要记得先清除微信的缓存，确保完全退出小程序后再次进入进行测试，确保咱们的改动可以实时更新

最后上一下效果图，有问题的小伙伴大家可以讨论一下～(￣▽￣～)~

小程序