一:企微实现和企业间的微信客服消息接收和事件原理
新版企微主要通过2个阶段实,第一个:消息推送 概述 - 文档 - 企业微信开发者中心 ,第二个:微信客服 接收消息和事件 - 文档 - 企业微信开发者中心
二:代码逻辑分析
1、消息推送 概述 - 文档 - 企业微信开发者中心
企微所有的消息都是通过这个主体接收,然后将消息内容放在Encrypt节点里面,如下图
返回对象log打印结果实例:
后端日志控制台返回:
<xml><ToUserName><![CDATA[wwaf9f23ec4871e]]></ToUserName><Encrypt><![CDATA[LJzYB4kTu5qFbSDoW1beSl7ZlMBMsf8rvFPO7aaO/UNUipytMzGer6oQBxGcdvtd4zE6o7OPliGvUqxdOaiTIUeUAbqvSld92guwwUXhlsaipIfPo7BU2SJ2Lg5xClCXmTSRA2PZ6NVEk6n9WLjHieXzNp/1pLVjadNueXVZjQLCEL2yQQmZmSMqGlz4KfKy9XfkyuyKCTEmBIcwmOxMEvWtslQOtlSDnZhCV6KNkV4gK+dlBa0gJQthpTYt7UGyB5PagFQhDDdpFRonyE746BiNkNNyqxyCQBCp50ldWItuixEUM40LL95V0Z/wKaQDkPMV1H1WRrr+9eqUM3/NAz0HojMtTjrqIlDimwiEkMgOlMY6PLwKP9JdDrjJU3VfDS5SxYOpnQxmBU6JLk7yAsd1ssb1LaHwReCciW4vVUoTKHhQ5BTkRpHfHQ7TuTQ1bhPZKE5yXK7hkXKG8XSxnbCiMmnp+Szm41K4XpOr8QOmmKsrX646hGyja489IrKMaZ3LzCT2vHKloBozsurvydrqkUhVoU5my/r7yE3ctMLxua7mvXX3AbzIXt7lt4OfhNIyo1Am5oGAA==]]></Encrypt><AgentID><![CDATA[1060109]]></AgentID></xml>
客服消息也会在Encrypt里面
2、微信客服 接收消息和事件 - 文档 - 企业微信开发者中心
获取客服消息,需要解析主体中的Encrypt,拿到里面的数据。
解密后,你会发现,Encrypt里面的内容就是如下格式数据:
<xml>
<ToUserName><![CDATA[ww12345678910]]></ToUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[kf_msg_or_event]]></Event>
<Token><![CDATA[ENCApHxnGDNAVNY4AaSJKj4Tb5mwsEMzxhFmHVGcra996NR]]></Token>
<OpenKfId><![CDATA[wkxxxxxxx]]></OpenKfId>
</xml>
到此,逻辑就基本出来了!
很重要的一点要理解,这个消息的使用逻辑,看企微api文档你发现就是这一块那一块的。实际就是做的一件事,实际就是一个包含关系—— 【微信客服-接收消息和事件】都是放在 【企业微信-消息推送】这个大的主体里面的!
1、企微后台自建应用绑定事件url:
2、企微里面的微信客服应用添加应用的自建客服
理解到这里,基本就很简单了。
通过个人微信扫码企微自建应用的接待客服二维码,用个人微信发送消息后,企微这时候自建应用事件触发,会用调用我们配置的接收事件URL,把信息加密推给我们后端服务。在后端事件处理的servlet里面接收企微推送的消息内容!
下面是一个java Servlet 入口的实现!
import cn.hutool.json.JSONUtil;
import lombok.extern.slf4j.Slf4j;
import org.jeecg.modules.ww.kf.service.IWorkWeixinKfEventStrategy;
import org.jeecg.modules.ww.kf.util.UtilHelp;
import org.jeecg.modules.ww.sys.json_callback.com.qq.weixin.mp.aes.AesException;
import org.jeecg.modules.ww.sys.json_callback.com.qq.weixin.mp.aes.WXBizJsonMsgCrypt;
import org.jeecg.modules.ww.wechatkfmsgrecord.service.ITblWechatKfMsgRecordService;
import org.jeewx.api.mp.aes.WXBizMsgCrypt;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.context.WebApplicationContext;
import org.springframework.web.context.support.WebApplicationContextUtils;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
@Slf4j
@WebServlet(name = "kfCallbackServlet",urlPatterns = "/qw*****ck")
public class WorkWeixinKfCallbackServlet extends HttpServlet {
@Autowired
private ITblWechatKfMsgRecordService kfMsgRecordService;
private WebApplicationContext applicationContext;
private static final long serialVersionUID = 1L;
/**
* @see HttpServlet#HttpServlet()
*/
public WorkWeixinKfCallbackServlet() {
super();
}
@Override
public void init(javax.servlet.ServletConfig config) throws ServletException {
super.init(config);
javax.servlet.ServletContext servletContext = config.getServletContext();
this.applicationContext = WebApplicationContextUtils.getRequiredWebApplicationContext(servletContext);
}
@Override
public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 处理Servlet请求逻辑
log.info("WeiXinCheckUrl 处理Servlet请求逻辑");
String method = request.getMethod();
if ("GET".equalsIgnoreCase(method)) {
// 处理GET请求
doGet(request,response);
} else if ("POST".equalsIgnoreCase(method)) {
// 处理POST请求
doPost(request,response);
}
}
/**
get方法主要用来做验证企微事件的url
* msg_signature 是 企业微信加密签名,msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体
* timestamp 是 时间戳
* nonce 是 随机数
* echostr 是 加密的字符串。需要解密得到消息内容明文,解密后有random、msg_len、msg、CorpID四个字段,