一、简介
当用户主动发消息给公众号的时候(包括发送信息、点击自定义菜单、订阅事件、扫描二维码事件、支付成功事件、用户维权),微信将会把消息数据推送给开发者,开发者在一段时间内(目前修改为48小时)可以调用客服消息接口,通过post一个json数据包来发送消息给普通用户,在48小时内不限制发送次数。此接口主要用于客服等有人工消息处理环节的功能,方便开发者为用户提供更加优质的服务。
二、思路分析
官方文档中只提供了一个发送客服消息的接口,开发者只要post一个特定的json数据包即可实现消息回复。在这里,我们打算做成一个简单的平台,可以记录用户消息,并且用网页表格的形式显示出来,然后可以对消息进行回复操作。
首先,我们使用数据库记录用户主动发送过来的消息,然后再提取出来展示到页面,针对该消息,进行回复。这里我们只讨论文本消息,关于其他类型的消息,大家自行研究。
三、记录用户消息
3.1 创建数据表
创建一张数据表tbl_customer 来记录用户消息。
-- -- 表的结构 `tbl_customer` -- create table `tbl_customer` ( `id` bigint(20) unsigned not null auto_increment comment '//消息id', `from_user` char(50) not null comment '//消息发送者', `message` varchar(200) not null comment '//消息体', `time_stamp` datetime not null comment '//消息发送时间', primary key (`id`), key `from_user` (`from_user`) ) engine=myisam default charset=utf8 ;
3.2 创建sql.func.php 文件
创建 _query($_sql) {} 函数,来执行insert 操作。
function _query($_sql){ if(!$_result = mysql_query($_sql)){ exit('sql执行失败'.mysql_error()); } return $_result; }
3.3 创建记录消息的函数文件record_message.func.inc.php
//引入数据库处理函数 require_once 'sql.func.php'; function _record_message($fromusername,$keyword,$date_stamp){ //调用_query()函数 _query("insert into tbl_customer(from_user,message,time_stamp) values('$fromusername','$keyword','$date_stamp')"); }
3.4 处理并记录文本消息
a. 引入回复文本的函数文件,引入记录消息的函数文件
//引入回复文本的函数文件 require_once 'responsetext.func.inc.php'; //引入记录消息的函数文件 require_once 'record_message.func.inc.php';
b. 记录消息入数据库,并返回给用户刚才发送的消息,在这里,你可以修改成其他的文本,比如:“你好,消息已收到,我们会尽快回复您!” 等等。
//处理文本消息函数 public function handletext($postobj) { //获取消息发送者,消息体,时间戳 $fromusername = $postobj->fromusername; $keyword = trim($postobj->content); $date_stamp = date('y-m-d h:i:s'); if(!empty( $keyword )) { //调用_record_message()函数,记录消息入数据库 _record_message($fromusername,$keyword,$date_stamp); $contentstr = $keyword; //调用_response_text()函数,回复发送者消息 $resultstr = _response_text($postobj,$contentstr); echo $resultstr; }else{ echo "input something..."; } }
四、网页展示用户消息
我们的最终效果大概如下所示,主要的工作在“信息管理中心”这块,其他的页面布局等等,不在这里赘述了,只讲解消息展示这块。
4.1 具体实施
引入数据库操作文件,执行分页模块,执行数据库查询,将查询出来的结果赋给$_result 供下面使用。
//引入数据库操作文件 require_once 'includes/sql.func.php'; //分页模块 global $_pagesize,$_pagenum; _page("select id from tbl_customer",15); //第一个参数获取总条数,第二个参数,指定每页多少条 $_result = _query("select * from tbl_customer order by id desc limit $_pagenum,$_pagesize");
将$_result 遍历出来,依次插入表格中。
<form> <table cellspacing="1"> <tr><th>消息idth><th>发送者th><th>消息体th><th>消息时间th><th>操作th>tr> php while(!!$_rows = _fetch_array_list($_result)){ $_html = array(); $_html['id'] = $_rows['id']; $_html['from_user'] = $_rows['from_user']; $_html['message'] = $_rows['message']; $_html['time_stamp'] = $_rows['time_stamp']; ?> <tr><td>php echo $_html['id']?>td><td>php echo $_html['from_user']?>td><td>php echo $_html['message']?>td><td>php echo $_html['time_stamp']?>td><td><a href="reply.php?fromusername=&message="><input type="button" value="回复" />a>td>tr> php } _free_result($_result); ?> table> form>
说明:在每条消息后,都有一个“回复”操作,点击该按钮,向reply.php文件中传入fromusername和用户发送的消息,为回复用户消息做准备。
五、消息回复
5.1 创建客服消息回复函数文件customer.php
微信发送客服消息的接口url如下:
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=access_token
需要post的json数据包格式如下:
{
"touser":"openid",
"msgtype":"text",
"text":
{
"content":"hello world"
}
}
所以,根据上面的提示,我们编写处理函数 _reply_customer($touser,$content),调用的时候,传入touser和需要回复的content,即可发送客服消息。
function _reply_customer($touser,$content){ //更换成自己的appid和appsecret $appid="wxef78f22f877db4c2"; $appsecret="3f3aa6ea961b6284057b8170d50e2048"; $token_url="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".$appid."&secret=".$appsecret; $json=file_get_contents($token_url); $result=json_decode($json); $acc_token=$result->access_token; $data = '{ "touser":"'.$touser.'", "msgtype":"text", "text": { "content":"'.$content.'" } }'; $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=".$acc_token; $result = https_post($url,$data); $final = json_decode($result); return $final; } function https_post($url,$data) { $curl = curl_init(); curl_setopt($curl, curlopt_url, $url); curl_setopt($curl, curlopt_ssl_verifypeer, false); curl_setopt($curl, curlopt_ssl_verifyhost, false); curl_setopt($curl, curlopt_post, 1); curl_setopt($curl, curlopt_postfields, $data); curl_setopt($curl, curlopt_returntransfer, 1); $result = curl_exec($curl); if (curl_errno($curl)) { return 'errno'.curl_error($curl); } curl_close($curl); return $result; }
下面,我们就将上面写好的函数引入到消息回复页面,实现发送客服消息的功能。
5.2 点击“回复”按钮,带上fromusername和message参数跳转到reply.php。
5.3 reply.php 页面显示
5.4 reply.php文件分析
//引入回复消息的函数文件 require_once '../customer.php';
form表单提交到relpy.php本身,带有action=relpy.
<form method="post" action="reply.php?action=reply"> <dl> <dd><strong>收件人:strong><input type="text" name="tousername" class="text" value="" />dd> <dd><strong>原消息:strong><input type="text" name="message" class="text" value="" />dd> <dd><span><strong>内 容:strong>span><textarea rows="5" cols="34" name="content">textarea>dd> <dd><input type="submit" class="submit" value="回复消息" />dd> dl> form>
action=reply 动作处理。
if($_get['action'] == "reply"){ $touser = $_post['tousername']; $content = $_post['content']; $result = _reply_customer($touser, $content); if($result->errcode == "0"){ _location('消息回复成功!', 'index.php'); } }
说明:post方式获取touser, content,然后调用_reply_customer($touser, $content)方法处理,处理成功,则弹出“消息回复成功!”,然后跳转到index.php页面,完成发送客服消息过程。
六、测试
6.1 微信用户发送消息
6.2 平台消息管理
6.3 发送客服消息
再次发送客服消息
发送客服消息测试成功!
七、代码获取
https://files.cnblogs.com/mchina/customer.rar
八、总结
微信发送客服消息本身很简单,只需post一个json数据包到指定接口url即可。这里我们进行了扩展,写成一个简单的平台,方便企业的管理。还有很多需要补充和改进的地方,例如,记录客服发送的消息;将相同用户的消息记录成一个集合;实现其他格式的消息回复等,有待读者自行思考开发。