小程序消息推送及客服(JAVA后台)

小程序客服及消息推送开发(后台JAVA)

最近公司在做小程序,涉及到客服及消息推送,简单的记录下开发过程及心得

客服

小程序自带的有客服功能只需要开启就行了.

选择开启后即可使用.

消息推送

首先在开发开发设置中配置消息推送

URL: 服务器设置自己服务器的路径.
Token(令牌): 自己设置,后面再自己的URL需对应.
EncodingAESkey(消息加密秘钥):涉及到加密解密,自己设置,推荐使用随机生成.
消息加密方式: 我这里选择的是明文模式.
数据格式: XML 和 JSON 都行,我选择的是JSON(听说JSON有问题,不过目前没遇到).

配置完后点击保存配置,此时微信端会发送一个GET请求到之前配置的URL路径中进行校检.废话不说直接贴代码

 // 与接口配置信息中的Token要一致private static String WECHAT_TOKEN = "ZIJIESHANYAO";
@RequestMapping("/checkToken")public void get(HttpServletRequest request, HttpServletResponse response) throws Exception {boolean isGet = request.getMethod().toLowerCase().equals("get");PrintWriter print;if (isGet) {// 微信加密签名String signature = request.getParameter("signature");// 时间戳String timestamp = request.getParameter("timestamp");// 随机数String nonce = request.getParameter("nonce");// 随机字符串String echostr = request.getParameter("echostr");// 通过检验signature对请求进行校验，若校验成功则原样返回echostr，表示接入成功，否则接入失败if (signature != null && checkSignature(signature, timestamp, nonce)) {System.out.println("111111111");System.out.println("jiaoyanchenggong");try {print = response.getWriter();print.write(echostr);print.flush();} catch (IOException e) {e.printStackTrace();}} else {}} else {}}/*** 验证签名** @param signature* @param timestamp* @param nonce* @return*/public static boolean checkSignature(String signature, String timestamp, String nonce) {String[] arr = new String[]{WECHAT_TOKEN, timestamp, nonce};// 将token、timestamp、nonce三个参数进行字典序排序// Arrays.sort(arr);sort(arr);StringBuilder content = new StringBuilder();for (int i = 0; i < arr.length; i++) {content.append(arr[i]);}MessageDigest md = null;String tmpStr = null;try {md = MessageDigest.getInstance("SHA-1");// 将三个参数字符串拼接成一个字符串进行sha1加密byte[] digest = md.digest(content.toString().getBytes());tmpStr = byteToStr(digest);} catch (NoSuchAlgorithmException e) {e.printStackTrace();}content = null;// 将sha1加密后的字符串可与signature对比，标识该请求来源于微信return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;}/*** 将字节数组转换为十六进制字符串** @param byteArray* @return*/private static String byteToStr(byte[] byteArray) {String strDigest = "";for (int i = 0; i < byteArray.length; i++) {strDigest += byteToHexStr(byteArray[i]);}return strDigest;}/*** 将字节转换为十六进制字符串** @param mByte* @return*/private static String byteToHexStr(byte mByte) {char[] Digit = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};char[] tempArr = new char[2];tempArr[0] = Digit[(mByte >>> 4) & 0X0F];tempArr[1] = Digit[mByte & 0X0F];String s = new String(tempArr);return s;}public static void sort(String a[]) {for (int i = 0; i < a.length - 1; i++) {for (int j = i + 1; j < a.length; j++) {if (a[j].compareTo(a[i]) < 0) {String temp = a[i];a[i] = a[j];a[j] = temp;}}}}

校检成功后就可以选择模板进行设置发送消息了,至于如何设置选择模板,这里不多说,直接看下就知道了,下面说下消息推送的具体实现.
第一步 : 获取模板 ID 自己去选择适合自己的模板 https://mp.weixin.qq.com
第二步 : 获取form_id ,前端设置按钮,点击按钮提交表单可以获取 formId(对于后台,直接去找前端要就行了).
第三步 : 调用接口具体的实现.

/** 微信小程序推送单个用户* */@RequestMapping(value = "/Phsu", method = RequestMethod.POST)@ResponseBodypublic String pushOneUser(String openid, String formid, Long orderId) {//获取access_tokenString access_token = getAccess_token(Global.appId, Global.secret);//这里是自己小程序的appId和secretKeyString url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send" +"?access_token=" + access_token;//拼接推送的模版WxMssVo wxMssVo = new WxMssVo();wxMssVo.setTouser(openid);//用户openidwxMssVo.setTemplate_id("DkA9fB-xmODJLVf1JvRtWdxr5-iTGETOfV5_6Nuk8NU");//模版idwxMssVo.setForm_id(formid);//formidMap<String, TemplateDataVo> m = new HashMap<>();if (order.getStatus().equals(20)) {List<OrderProduct> orderProducts = order.getOrderProducts();String ProductName = null;for (OrderProduct orderProduct : orderProducts) {ProductName = orderProduct.getName();}TemplateDataVo keyword1 = new TemplateDataVo();keyword1.setValue(ProductName);//商品名称m.put("keyword1", keyword1);wxMssVo.setData(m);System.out.println(keyword1.getValue() + ":name");TemplateDataVo keyword2 = new TemplateDataVo();keyword2.setValue(order.getOrderSn() + "");//订单编号m.put("keyword2", keyword2);wxMssVo.setData(m);System.out.println(keyword2.getValue() + ":bianhao");TemplateDataVo keyword3 = new TemplateDataVo();keyword3.setValue(order.getTotalPrice() + "");//订单金额m.put("keyword3", keyword3);wxMssVo.setData(m);System.out.println(keyword3.getValue() + ":jine");TemplateDataVo keyword4 = new TemplateDataVo();keyword4.setValue(order.getPoyTime() + "");//支付时间m.put("keyword4", keyword4);wxMssVo.setData(m);System.out.println(keyword4.getValue() + ":time");}ResponseEntity<String> responseEntity =restTemplate.postForEntity(url, wxMssVo, String.class);System.out.println(responseEntity.getBody() + "wancheng");//发送成功return responseEntity.getBody()}
/** 获取access_token* appid和appsecret到小程序后台获取，当然也可以让小程序开发人员给你传过来* */public String getAccess_token(String appid, String appsecret) {//获取access_tokenString url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential" +"&appid=" + appid + "&secret=" + appsecret;String json = restTemplate.getForObject(url, String.class);AccessToken accessToken = new Gson().fromJson(json, AccessToken.class);return accessToken.getAccess_token();}

@Getter@Setter
public class AccessToken {private String access_token;
}

/*** 微信平台一些固定参数*/
@Data
public class Global {// 小程序唯一标识 (在微信小程序管理后台获取)public static final String appId = "";// 小程序的 app secret (在微信小程序管理后台获取)public static final String secret = "";// 授权（必填）public static final String grant_type = "";//请求地址public static final String requestUrl="https://api.weixin.qq.com/sns/jscode2session";public String getAppId(){return appId;}public String getSecret(){return secret;}public String getGrant_type(){return grant_type;}public String getRequestUrl(){return requestUrl;}
}

至此消息推送完成.

但是随后发现之前配置的客服不能使用了

看下文档, https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/trans.html 发现
如果配置了消息推送,所有用户发给小程序的消息都会被转发到已填写的服务器地址中,此时我们需要处理的是将微信转发到后台的消息取出返回给客服,并将客服消息返回给用户.
官网上有对各种消息的具体格式.https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/customer-message/receive.html
下面我只处理文本形式.
当微信将消息推送到后台,会推送到之前配置的URL 地址,以POST请求的方式.

/*** 接收微信后台发来的用户消息* @return*/@RequestMapping(value = "/checkToken", method = RequestMethod.POST)@ResponseBodypublic String receiveMessage(@RequestBody Map<String, Object> msg) {//获取tokenString access_token = getAccess_token(Global.appId, Global.secret);System.out.println("access_token:--------" + access_token);//用户openIdString fromUserName = msg.get("FromUserName").toString();String createTime = msg.get("CreateTime").toString();String toUserName = msg.get("ToUserName").toString();String msgType = msg.get("MsgType").toString();if (msgType.equals("text")) { //收到的是文本消息,并将消息返回给客服HashMap<String, Object> 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();}//客服方面,也回复一个文本消息JSONObject text = new JSONObject();text.element("content", msg.get("MsgType"));JSONObject json = new JSONObject();json.element("touser", toUserName);json.element("text", text);json.element("msgtype", "text");//发送aipsendMsToCustomer(access_token, json);return "success";}/*** 用户发送消息给客服** @param json 消息的参数*/private void sendMsToCustomer(String access_token, JSONObject json) {RestTemplate restTemplate = new RestTemplate();//access_tokenString result = restTemplate.postForEntity("https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=" +access_token, json, String.class).getBody();}

至此,消息推送及客服全部完成.

总结

其实整体流程还是比较简单的,只是开启消息推送的有点坑之外其他的还好说,做之前多看几遍文档熟悉,新人第一次写博客如有错误请指正,共同学习.