公司的小程序最近开始接入小程序的客服功能，主要实现能够自动回复以及人工回复。查阅微信开放文档后，也基本上完成了需求，但是其中遇到了很多问题，现在总结一下。

接入方式的选择

微信的文档中说的是可以有3种实现方式：
1.开发者服务器接收消息推送
2.云函数接收消息推送
3.云托管服务接收消息推送
当然我这里选择的是第一种方式。

接入步骤

第一步：填写服务器配置

登录小程序后台后，在「开发」-「开发设置」-「消息推送」中，管理员扫码启用消息服务，填写服务器地址（URL）、令牌（Token）和消息加密密钥（EncodingAESKey）等信息。
$\color{red}{这里要注意的是端口号一定是80或者443，也就是对应http或者https，一旦确认了URL后，就不要轻易改动了，每个月只有3次修改URL的机会哦~}$

第二步：验证消息的确来自微信服务器

开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上。
$\color{red}{这里最好还是按照文档中的要求，进行字段的验证，不要在接口中直接返回echostr，验证的方法，在别的博客上能搜索到相应的Java代码。}$

第三步：接收消息和事件

当某些特定的用户操作引发事件推送时（如用户向小程序客服发送消息、或者进入会话等情况），微信服务器会将消息（或事件）的数据包以 POST 请求发送到开发者配置的 URL，开发者可以依据自身业务逻辑进行响应。

1.消息类型以及事件类型

目前发现的消息类型有:
1)text:普通文本消息
2)image:图片消息
3)miniprogrampage:小程序卡片
4)link:链接
5)event:事件
目前发现的事件类型有:
1)user_enter_tempsession:用户进入客服会话
2)kf_create_session:人工客服进入，客服助手小程序，注意这里不是指跟特定的用户聊天而仅仅是进入客服助手聊天列表
3)subscribe_msg_sent_event:小程序订阅消息

2.接口参数接受

由于消息类型和事件类型以及是否加密等不确定性，所以推荐使用Map类型参数进行参数的接收，其中参数基本包含如下字段:
1)MsgType:消息类型
2)Content:文本消息消息内容
2)FromUserName:用户openid
2)ToUserName:小程序的原始ID
2)CreateTime:消息创建时间
2)Event:当MsgType为event的时候，会有指定的Event类型

3.怎么进行消息回复

刚开始我以为微信是利用我们提供的POST接口进行消息回复的，还是我太年轻啊，我们提供的POST接口目前是两个作用，一是告诉调用这个接口的服务我们处理成功了，根据文档可以进行如下回复：
1)直接回复success（推荐方式）
2)直接回复空串（指字节长度为0的空字符串，而不是结构体中content字段的内容为空）
3)若接口文档有指定返回内容，应按文档说明返回
二是进行消息转发，下面会说到，这里我直接回复success。也就是说，如果我们要自动回复用户发送的消息，还需要采用其他的方式，脚指头想一下，可能是调用微信特定的接口，事实上就是这样，具体调用的是
https://api.weixin.qq.com/cgi-bin/message/custom/send
这个接口，但是我们可以自己不用去调用这个接口，这里重点来了，注意啦！！！我们引入一个库如下：

        
            com.github.binarywang
            weixin-java-miniapp
            ${weixin-java.version}

这个库封装了大部分小程序开发过程中，需要用到的微信调用，很方便的，而且我们自己不用去管那个access_token！那关于这个库的配置什么的，这里我就不说了，你们自己去网上百度吧，这里我们使用库提供的WxMaMsgService中的sendKefuMsg方法进行消息自动回复，至于消息的类型以及怎么创建出消息，你们可以自己点到方法生命中去摸索。

4.怎么转发消息到人工客服

这时候你会发现，自动回复的功能是实现了，但是人工客服那边却收不到消息，这可怎么办啊，那么这个时候我们提供的POST接口就起作用了，对于需要转发的消息，可以通过进行特定的回复来实现，这里我贴下具体代码：

        HashMap resultMap = new HashMap<>();
        resultMap.put("ToUserName", fromUserName);
        resultMap.put("FromUserName", toUserName);
        resultMap.put("CreateTime", Long.parseLong(createTime));
        resultMap.put("MsgType", "transfer_customer_service");
        String json = JSON.toJSONString(resultMap);
        com.alibaba.fastjson.JSONObject result = com.alibaba.fastjson.JSONObject.parseObject(json);
        return result.toString();

5.转发消息到人工客服后服务端会收不到消息?

到目前为止好像自动回复和人工回复的功能都实现了，但是有没有发现，在人工客服介入之后，我们的服务却收不到微信给我们转的消息了，这是为什么?查阅文档发现:
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/trans.html
用户被客服接入以后，客服关闭会话以前，处于会话过程中时，用户发送的消息均会被直接转发至客服系统。当会话超过 30 分钟客服没有关闭时，微信服务器会自动停止转发至客服，而将消息恢复发送至开发者填写的 URL 上。
用户在等待队列中时，用户发送的消息仍然会被推送至开发者填写的 URL 上。

6.Media_Id怎么获取

在进行image或者miniprogrampage类型消息发送的时候,是需要一个media_id的，那么这个media_id怎么获取呢？通过调用
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
这个接口进行文件上传，这里同样注意，我们不需要自己调用，使用上面提到的库中的WxMaMediaService的uploadMedia方法进行文件上传

7.消息回复限制

有时候发消息给用户会报条数限制的错误,查阅文档后发现：
https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/send.html
当用户和小程序客服产生特定动作的交互时（具体动作列表请见下方说明），微信将会把消息数据推送给开发者，开发者可以在一段时间内（目前为 48 小时）调用客服接口，通过调用发送客服消息接口来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。
这里需要注意的是不能直接发送消息给新用户,超过48小时后不能发送,超过5条不能发送

8.事件类型处理

有时候不是所有转发过来的消息我们都需要处理或者转发到人工那边,比如客服接入的事件,订阅消息发送的事件,所以在代码里有必要进行处理,我这里处理了人工客服接入,进行提示

        if (MSG_TYPE_EVENT.equals(msgType)
                && !EVENT_KF_CREATE_SESSION.equals(msgEvent)) {
            //对于事件一律不转发,除了人工客服接入
            return "success";
        }

9.发送的小程序卡片,跳转不到指定页面?

在小程序内部打开客服界面,推给用户的小程序卡片,用户在点击之后是不能直接跳转到指定的页面的,这个时候需要前端给button加上bindcontact属性,然后获取里面的路径以及参数进行手动跳转就行了。

Java后端接入微信小程序消息推送服务的注意事项