微信公眾平臺開發（十二）傳送客服訊息

Merlin_Tang發表於2014-05-06

一、簡介

當使用者主動發訊息給公眾號的時候（包括髮送資訊、點選自定義選單、訂閱事件、掃描二維碼事件、支付成功事件、使用者維權），微信將會把訊息資料推送給開發者，開發者在一段時間內（目前修改為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>訊息ID</th><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=<?php echo $_html['from_user']?>&message=<?php echo $_html['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="<?php echo $from_username?>" /></dd>
        <dd><strong>原訊息：</strong><input type="text" name="message" class="text" value="<?php echo $message?>" /></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');
    }
}