微信小程序消息推送

---

简介

微信小程序发送消息推送到用户微信上

基础流程

1. 用户登录 ：获取微信提供的openid
2. 开发者去微信公众平台申请模板：获得模板id
3. 授权消息推送：在小程序中调用wx.requestSubscribeMessage方法
4. 成功后将数据保存到后台 消息推送表 中
5. 在需要发送消息推送时：查询 消息推送表 如果有，使用 消息推送表 的数据调用接口subscribeMessage.send

细节流程

1.1用户微信登录（缓存opid）
1.2用户普通登录(无opid)

2 消息推送申请
2.1用户授权
2.1.1无opid（弹框要求 微信登录（类似第一步）
2.1.2有opid（继续
2.2获得了授权的模板id和opid
3传输到后台，后台存储到消息推送表，参数：模板id，opid,用户名称，身份证。默认参数：是否发送为N，创建时间，主键 ，发送时间为空
4后台定时器，查询到要发送的用户时，查询消息推送表,修改发送状态为Y，更新发送时间，然后发送微信小程序消息推送

代码

1用户微信小程序登录

wx.login({
        success: res => {
          console.log(res);
          // 发送 res.code 到后台换取 openId, sessionKey, unionId
          request.post('后台用小程序id和密钥获取Openid的接口.do', {
            code: res.code
          }).then((res) => {
            console.log(res);
            let result = JSON.parse(res.result);
            wx.setStorageSync('openid',result.openid)//缓存openid
            that.setData({
              sessionKey: result.session_key
            })
          });
        }
      })

2 小程序消息推送授权

let templateId = '模板id';
wx.requestSubscribeMessage({
      tmplIds: [templateId],
      success (res) {
        console.log(res);
        if(res.模板id =='reject'){//被拒绝

        }else{//同意
//获取缓存的openid,可能是之前用户登录时存放的
          let opid = wx.getStorageSync('openid');
          //如果有OPID,直接发送
          if(opid){
//执行保存到后台的操作
            that.saveSubMssage(opid,templateId);
          }else{

              wx.showToast({
                title: '需要关联微信账号',
                icon: 'success',
                duration: 2000
              })
//和登录授权一样
              wx.login({
                success: res => {
                  console.log(res);
                  // 发送 res.code 到后台换取 openId, sessionKey, unionId
                  request.post('后台换取用户id的接口', {
                    code: res.code
                  }).then((res) => {
//得到openid
                    let result = JSON.parse(res.result);
                    wx.setStorageSync('openid',result.openid)
                    opid=res.openid;
//执行保存到后台的操作
                    that.saveSubMssage(opid,templateId);
                  });
                }
              })
            }
        }
      },
      error(res){
        console.log(res);
        wx.showToast({
          title: '授权出现错误',
          icon: 'none',
          duration: 2000
        })
      }
    })

saveSubMssage(openid,tmplIds){
    let that = this;
    request.Post('后台保存用户同意消息推送的接口.do', {
      openId: openid,//用户openid
      templateId: tmplIds,//模板id
      userName: encodeURI(that.data.userName),//中文乱码处理
      idCard: that.data.idCard//身份证
    }).then((res) => {
      console.log(res);

      wx.showToast({
        title: '授权成功',
        icon: 'success',
        duration: 2000
      })

//退出页面
      setTimeout(function() {
          wx.navigateBack({ changed: true });
      }, 2000);
    });

3 后台保存用户同意消息推送的接口

 @RequestMapping(value="/SaveMessageAuthority.do" ,produces = "application/json;charset=UTF-8")
    @ResponseBody
    public String SaveMessageAuthority(String openId,String templateId,String userName ,String idCard) throws Exception {
        try {
            WeChatMessageAuthorityPO weChatMessageAuthority = new WeChatMessageAuthorityPO();
            weChatMessageAuthority.setOpenId(openId);
            weChatMessageAuthority.setTemplateId(templateId);
            weChatMessageAuthority.setIdCard(idCard);
//            String temp = request.getParameter("studentName");
            if(StringUtils.isNotEmpty(userName)){
                userName = java.net.URLDecoder.decode(userName,"UTF-8");
                weChatMessageAuthority.setUserName(userName);
            }
            weChatMessageAuthority.setCreateDate(new Date());
            weChatMessageAuthority.setIsSend(BaseStaticParameter.NO);
            iWxMassageAuthorityService.saveOrUpdate(weChatMessageAuthority);

        }catch (Exception e){
            e.printStackTrace();
            return "false";
        }

        return "true";
    }

4 后台发送推送信息

public static boolean sendNearRemindMessage(String openId,String serveName,String windowName,String lineNumber,String waitNumber,String msg) throws Exception {

        WxMaSubscribeMessage subscribeMessage = new WxMaSubscribeMessage();

        //跳转小程序页面路径
        subscribeMessage.setPage("pages/index/index");
        //模板消息id
        subscribeMessage.setTemplateId(WxMaConfiguration.templateId);
        //给谁推送 用户的openid （可以调用根据code换openid接口)
        subscribeMessage.setToUser(openId);
        //==========================================创建一个参数集合========================================================
        ArrayList<WxMaSubscribeData> wxMaSubscribeData = new ArrayList<>();

//        订阅消息参数值内容限制说明
//              ---摘自微信小程序官方：https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
//        参数类别 	参数说明 	参数值限制 	   说明
//        thing.DATA 	事物 	20个以内字符 	可汉字、数字、字母或符号组合
//        number.DATA 	数字 	32位以内数字 	只能数字，可带小数
//        letter.DATA 	字母 	32位以内字母 	只能字母
//        symbol.DATA 	符号 	5位以内符号 	只能符号
//        character_string.DATA 	字符串 	32位以内数字、字母或符号 	可数字、字母或符号组合
//        time.DATA 	时间 	24小时制时间格式（支持+年月日） 	例如：15:01，或：2019年10月1日 15:01
//        date.DATA 	日期 	年月日格式（支持+24小时制时间） 	例如：2019年10月1日，或：2019年10月1日 15:01
//        amount.DATA 	金额 	1个币种符号+10位以内纯数字，可带小数，结尾可带“元” 	可带小数
//        phone_number.DATA 	电话 	17位以内，数字、符号 	电话号码，例：+86-0766-66888866
//        car_number.DATA 	车牌 	8位以内，第一位与最后一位可为汉字，其余为字母或数字 	车牌号码：粤A8Z888挂
//        name.DATA 	姓名 	10个以内纯汉字或20个以内纯字母或符号 	中文名10个汉字内；纯英文名20个字母内；中文和字母混合按中文名算，10个字内
//        phrase.DATA 	汉字 	5个以内汉字 	5个以内纯汉字，例如：配送中

        WxMaSubscribeData wxMaSubscribeData1 = new WxMaSubscribeData();
        wxMaSubscribeData1.setName("thing1");
        wxMaSubscribeData1.setValue(serveName);
        wxMaSubscribeData.add(wxMaSubscribeData1);

        WxMaSubscribeData wxMaSubscribeData2 = new WxMaSubscribeData();
        wxMaSubscribeData2.setName("thing6");
        wxMaSubscribeData2.setValue(windowName);
        wxMaSubscribeData.add(wxMaSubscribeData2);

        WxMaSubscribeData wxMaSubscribeData3 = new WxMaSubscribeData();
        wxMaSubscribeData3.setName("character_string2");
        wxMaSubscribeData3.setValue(lineNumber);
        wxMaSubscribeData.add(wxMaSubscribeData3);

        WxMaSubscribeData wxMaSubscribeData4 = new WxMaSubscribeData();
        wxMaSubscribeData4.setName("number3");
        wxMaSubscribeData4.setValue(waitNumber);
        wxMaSubscribeData.add(wxMaSubscribeData4);

        WxMaSubscribeData wxMaSubscribeData5 = new WxMaSubscribeData();
        wxMaSubscribeData5.setName("thing5");
        wxMaSubscribeData5.setValue(msg);//"快到您了，请关注窗口和叫号情况"
        wxMaSubscribeData.add(wxMaSubscribeData5);

        //把集合给大的data
        subscribeMessage.setData(wxMaSubscribeData);
        //=========================================封装参数集合完毕========================================================

        try {
            System.out.println(JsonUtil.toJSONString(subscribeMessage));
            //获取微信小程序配置：

            final WxMaService wxService = WxMaConfiguration.getMaService(WxMaConfiguration.appid);
            //进行推送
            wxService.getMsgService().sendSubscribeMsg(subscribeMessage);
            return true;
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println(e.toString());
        }
        return false;
    }

5 微信maven（微信调用方式可选）

        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-miniapp</artifactId>
            <version>3.6.0</version>
        </dependency>

6 WxMaConfiguration

import cn.binarywang.wx.miniapp.api.WxMaService;
import cn.binarywang.wx.miniapp.api.impl.WxMaServiceImpl;
import cn.binarywang.wx.miniapp.bean.WxMaKefuMessage;
import cn.binarywang.wx.miniapp.bean.WxMaMessage;
import cn.binarywang.wx.miniapp.bean.WxMaTemplateData;
import cn.binarywang.wx.miniapp.bean.WxMaTemplateMessage;
import cn.binarywang.wx.miniapp.config.impl.WxMaDefaultConfigImpl;
import cn.binarywang.wx.miniapp.message.WxMaMessageHandler;
import cn.binarywang.wx.miniapp.message.WxMaMessageRouter;
import cn.binarywang.wx.miniapp.message.WxMaXmlOutMessage;
import com.google.common.collect.Lists;
import com.google.common.collect.Maps;
import me.chanjar.weixin.common.bean.result.WxMediaUploadResult;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.common.session.WxSessionManager;
import org.springframework.context.annotation.Configuration;

import javax.annotation.PostConstruct;
import java.io.File;
import java.util.Map;

/**
 * create by zhaojiong
 * 22-8-16
 */
@Configuration
public class WxMaConfiguration {

    //叫号
    public final static String jh_templateId = "
消息模板id";
    //排队
    public final static String pd_templateId = "消息模板id";
    public final static String appid = "按情况填写";
    public final static String secret = "按情况填写";
    public final static String token = "按情况填写";
    public final static String aesKey = "按情况填写";
    public final static String msgDataFormat = "JSON";
//
    private static Map<String, WxMaMessageRouter> routers = Maps.newHashMap();
    private static Map<String, WxMaService> maServices = Maps.newHashMap();
//
//
    public static WxMaService getMaService(String appid) {
        WxMaService wxService = maServices.get(appid);
        if (wxService == null) {
            throw new IllegalArgumentException(String.format("未找到对应appid=[%s]的配置，请核实！", appid));
        }

        return wxService;
    }
//
    public static WxMaMessageRouter getRouter(String appid) {
        return routers.get(appid);
    }
//
//

    @PostConstruct
    public void init() {

        WxMaDefaultConfigImpl config = new WxMaDefaultConfigImpl();
        config.setAppid(appid);
        config.setSecret(secret);
        config.setToken(token);
        config.setAesKey(aesKey);
        config.setMsgDataFormat(msgDataFormat);

        WxMaService service = new WxMaServiceImpl();
        service.setWxMaConfig(config);
        routers.put(appid, this.newRouter(service));
        maServices.put(appid, service);

    }
//
    private WxMaMessageRouter newRouter(WxMaService service) {
        final WxMaMessageRouter router = new WxMaMessageRouter(service);
        router
                .rule().handler(logHandler).next()
                .rule().async(false).content("模板").handler(templateMsgHandler).end()
                .rule().async(false).content("文本").handler(textHandler).end()
                .rule().async(false).content("图片").handler(picHandler).end()
                .rule().async(false).content("二维码").handler(qrcodeHandler).end();
        return router;
    }

    private final WxMaMessageHandler templateMsgHandler = new WxMaMessageHandler() {
        @Override
        public WxMaXmlOutMessage handle(WxMaMessage wxMessage, Map<String, Object> context, WxMaService service, WxSessionManager sessionManager) throws WxErrorException {
            service.getMsgService().sendTemplateMsg(WxMaTemplateMessage.builder()
                    .templateId("此处更换为自己的模板id")
                    .formId("自己替换可用的formid")
                    .data(Lists.newArrayList(
                            new WxMaTemplateData("keyword1", "339208499", "#173177")))
                    .toUser(wxMessage.getFromUser())
                    .build());
            return null;
        }
    };

    private final WxMaMessageHandler logHandler = new WxMaMessageHandler() {
        @Override
        public WxMaXmlOutMessage handle(WxMaMessage wxMessage, Map<String, Object> context, WxMaService service, WxSessionManager sessionManager) throws WxErrorException {
            System.out.println("收到消息：" + wxMessage.toString());
            service.getMsgService().sendKefuMsg(WxMaKefuMessage.newTextBuilder().content("收到信息为：" + wxMessage.toJson())
                    .toUser(wxMessage.getFromUser()).build());
            return null;
        }
    };

    private final WxMaMessageHandler textHandler = new WxMaMessageHandler() {
        @Override
        public WxMaXmlOutMessage handle(WxMaMessage wxMessage, Map<String, Object> context, WxMaService service, WxSessionManager sessionManager) throws WxErrorException {
            service.getMsgService().sendKefuMsg(WxMaKefuMessage.newTextBuilder().content("回复文本消息")
                    .toUser(wxMessage.getFromUser()).build());
            return null;
        }
    };

    private final WxMaMessageHandler picHandler = new WxMaMessageHandler() {
        @Override
        public WxMaXmlOutMessage handle(WxMaMessage wxMessage, Map<String, Object> context, WxMaService service, WxSessionManager sessionManager) throws WxErrorException {
            try {
                WxMediaUploadResult uploadResult = service.getMediaService()
                        .uploadMedia("image", "png",
                                ClassLoader.getSystemResourceAsStream("tmp.png"));
                service.getMsgService().sendKefuMsg(
                        WxMaKefuMessage
                                .newImageBuilder()
                                .mediaId(uploadResult.getMediaId())
                                .toUser(wxMessage.getFromUser())
                                .build());
            } catch (WxErrorException e) {
                e.printStackTrace();
            }

            return null;
        }
    };

    private final WxMaMessageHandler qrcodeHandler = new WxMaMessageHandler() {
        @Override
        public WxMaXmlOutMessage handle(WxMaMessage wxMessage, Map<String, Object> context, WxMaService service, WxSessionManager sessionManager) throws WxErrorException {
            try {
                final File file = service.getQrcodeService().createQrcode("123", 430);
                WxMediaUploadResult uploadResult = service.getMediaService().uploadMedia("image", file);
                service.getMsgService().sendKefuMsg(
                        WxMaKefuMessage
                                .newImageBuilder()
                                .mediaId(uploadResult.getMediaId())
                                .toUser(wxMessage.getFromUser())
                                .build());
            } catch (WxErrorException e) {
                e.printStackTrace();
            }

            return null;
        }
    };

}

407a4f37-fd09-4b00-873c-0eaa1ca3b473