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

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

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

在页面中使用 <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");       //定义tokendefine("WXPAY_APPID", '***********');     //替换为自己的APPIDdefine("WXPAY_APPSECRET", '******************'); //替换为自己的APPSECRETclass vyuanCustomAPI{        //用于小程序后台第一步验证返回，验证成功后便可注释public function isValid(){$echoStr = $_GET["echostr"];if ($this->checkSignature()) {echo $echoStr;exit;}}//官方提供的验证demopublic 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);}//获取accesstokenpublic 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_idpublic 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>';}}