微信公众号开发之客服消息

发表于 | 更新于: | 分类于 | | 阅读次数:

完整代码地址： 微信公众号开发之客服消息

一、接入微信公众号平台

  • *从后台得到 appID 、appsecret， 以及自己填写的 token *

  • 通过微信服务器的验证

    开发者提交信息后，微信服务器将发送 GET 请求到填写的服务器地址 URL 上，会携带参数 signature、 timestamp、 nonce、 echostr

    根据开发文档给的校验方式， 校验是否由微信服务器发送的请求，确认之后发送 echostr 参数，则接入成功，代码如下：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    <?php

    $wechat = new wechatCallBack();

    if (isset($_GET['echostr'])) {
        $wechat->checkSignature();
    }

    class wechatCallBack
    {
        public $appid  = 'wx35*****48137';
        public $sercet = 'dd227*******aefaf4';
        public $token  = 'token';

        /**
         * 检验签名
         */
        public function checkSignature()
        {
            // 获得参数 signature nonce token timestamp echostr
            $nonce     = $_GET['nonce'];
            $timestamp = $_GET['timestamp'];
            $echostr   = $_GET['echostr'];
            $signature = $_GET['signature'];

            $array = array();

            $array = array($nonce, $timestamp, $this->token);

            sort($array);

            $str = sha1(implode($array));
            
            if ($str == $signature) {
                echo  $echostr;

                exit;
            }
        }
    }

二、获取 access_token

access_token 是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使用 access_token 。开发者需要进行妥善保存。access_token 的存储至少要保留512个字符空间。access_token 的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的 access_token 失效。

代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
public function getAccessToken()
{
    if (isset($_SESSION['access_token']) && time() < $_SESSION['expires_time']) {
        return $_SESSION['access_token'];
    } else {
        $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appid&secret=$this->sercet";

        $res = $this->getHttp($url);

        $resArr = json_decode($res, true);

        if (isset($resArr['access_token'])) {
            $_SESSION['access_token'] = $resArr['access_token'];
            $_SESSION['expires_time'] = time() + $resArr['expires_in'];

            return $resArr['access_token'];
        }
    }
}

三、对接客服消息

有了上面的 access_token ，接下来就可以对接 客服消息

当用户和公众号产生特定动作的交互时，微信将会把消息数据推送给开发者，开发者可以在一段时间内（目前修改为48小时）调用客服接口，通过 POST 一个 JSON 数据包来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。

1. 客服帐号管理

添加客服帐号

修改客服帐号

删除客服账号

设置客服账号的头像

获取所有客服账号

以上接口，可能测试号没有权限操作，一直返回以下代码：

1
{"errcode":65400,"errmsg":"please enable new custom service, or wait for a while if you have enabled hint: [g7c2tA05131503]"}

查了好久，没有找到为什么，那就归到官方不开放吧，等以后搞到个认证过的公众号再来补充了。

2. 客服发送接口

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<?php
    /**
     * 发送客服消息
     */
    public function sendCustomerMsg($obj)
    {
        $accessToken = $this->getAccessToken();

        $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=$accessToken";

        // 不指定某个客服回复
        $postData = array(
            'touser'  => "$obj->FromUserName",
            'msgtype' => 'text',
            'text'    => array (
                'content' => 'Hello a',
            )
        );

        // 指定某个客服回复
        // $postData = array(
        //     'touser'  => "$obj->FromUserName",
        //     'msgtype' => 'text',
        //     'customservice' => array(
        //         "kf_account" => "test1@kftest"
        //     ),
        //     'text'    => array(
        //         'content' => 'Hello a',
        //     )
        // );

        $res = $this->postHttp($url, json_encode($postData));

        $resArr = json_decode($res, true);

        if (isset($resArr['errcode']) && $resArr['errcode'] == 0) {
            $this->logger("\r\n" . '发送成功');

            return true;
        }

        $this->logger("\r\n" . $res);
    }

我这边是由一个自定义菜单 在线客服 按钮触发客服接口，你也可以自己设定其他事件来触发，具体如下

1
2
3
4
5
6
1、用户发送信息
2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权

3. 将消息转发到客服

如果公众号处于开发模式，普通微信用户向公众号发消息时，微信服务器会先将消息POST到开发者填写的url上，如果希望将消息转发到客服系统，则需要开发者在响应包中返回MsgType为transfer_customer_service的消息，微信服务器收到响应后会把当次发送的消息转发至客服系统。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
/**
 * 将消息转发到客服
 *
 * @return void
 *
 * @author zhengkexin
 *
 * @created 2019-04-19 17:02:49
 */
public function forwardCustomerService($obj)
{
    // 不指定转发
    $tmpXml = '<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[transfer_customer_service]]></MsgType>
            </xml>';

    // 指定转发到某客服
    $tmpXml1 = '<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[transfer_customer_service]]></MsgType>
                <TransInfo>
                    <KfAccount><![CDATA[test1@test]]></KfAccount>
                </TransInfo>
            </xml>';

    $resultXml = sprintf($tmpXml, $obj->FromUserName, $obj->ToUserName, time());

    echo $resultXml;
}

四、注意

网上很多教程都是用 $GLOBALS["HTTP_RAW_POST_DATA"] 来接收微信服务器发来的消息，但可能有一些人说没有接收到信息。

在 www.php.net 里关于这个预定义变量，有一个提醒

1
2
> Warning This feature was DEPRECATED in PHP 5.6.0, and REMOVED as of PHP 7.0.0.
>

此功能在PHP 5.6.0中已弃用，从PHP 7.0.0开始已删除。

所以他给出的是使用 php://input 来代替

望对你们有用，有什么不对也欢迎大家向我反馈，请多指教

您的支持将鼓励我继续创作！