spring boot項目之微信模板消息推送

1、打開微信公衆平臺的消息管理-->模板消息接口

 

發送模板消息（須要傳模板ID：template_id【在公衆平臺-->模板信息-->個人模板】）

 

 

接口調用請求說明

http請求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

POST數聽說明

POST數據示例以下：

{
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",  
           "miniprogram":{
             "appid":"xiaochengxuappid12345",
             "pagepath":"index?foo=bar"
           },          
           "data":{
                   "first": {
                       "value":"恭喜你購買成功！",
                       "color":"#173177"
                   },
                   "keyword1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keyword2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keyword3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"歡迎再次購買！",
                       "color":"#173177"
                   }
           }
       }

參數說明

參數	是否必填	說明
touser	是	接收者openid
template_id	是	模板ID
url	否	模板跳轉連接
miniprogram	否	跳小程序所需數據，不需跳小程序可不用傳該數據
appid	是	所需跳轉到的小程序appid（該小程序appid必須與發模板消息的公衆號是綁定關聯關係，暫不支持小遊戲）
pagepath	否	所需跳轉到小程序的具體頁面路徑，支持帶參數,（示例index?foo=bar），暫不支持小遊戲
data	是	模板數據
color	否	模板內容字體顏色，不填默認爲黑色

注：url和miniprogram都是非必填字段，若都不傳則模板無跳轉；若都傳，會優先跳轉至小程序。開發者可根據實際須要選擇其中一種跳轉方式便可。當用戶的微信客戶端版本不支持跳小程序時，將會跳轉至url。

返回碼說明

在調用模板消息接口後，會返回JSON數據包。正常時的返回JSON數據包示例：

{
           "errcode":0,
           "errmsg":"ok",
           "msgid":200228332
       }

使用效果

    

 2、打開項目，單獨創建一個service——PushMessage，用來作微信推送（主要推送的是訂單狀態變動消息）

實現PushMessageService接口的實現類PushMessageServiceImpl（WxMpService已經在WxchatConfig類上被注入，模板id也被註冊）

package com.imooc.service.impl;

import com.imooc.config.WechatAccountConfig;
import com.imooc.dto.OrderDTO;
import com.imooc.service.PushMessageService;
import lombok.extern.slf4j.Slf4j;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateData;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateMessage;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.Arrays;
import java.util.List;

@Service
@Slf4j
public class PushMessageServiceImpl implements PushMessageService {

    @Autowired
    private WxMpService wxMpService;

    @Autowired
    private WechatAccountConfig accountConfig;

    @Override
    public void orderStatus(OrderDTO orderDTO) {
        WxMpTemplateMessage templateMessage = new WxMpTemplateMessage();
        templateMessage.setTemplateId(accountConfig.getTemplateId().get("orderStatus"));
        templateMessage.setToUser(orderDTO.getBuyerOpenid());

        List<WxMpTemplateData> data = Arrays.asList(
                new WxMpTemplateData("first", "親，請記得收貨。"),
                new WxMpTemplateData("keyword1", "微信點餐"),
                new WxMpTemplateData("keyword2", "18868812345"),
                new WxMpTemplateData("keyword3", orderDTO.getOrderId()),
                new WxMpTemplateData("keyword4", orderDTO.getOrderStatusEnum().getMessage()),
                new WxMpTemplateData("keyword5", "￥" + orderDTO.getOrderAmount()),
                new WxMpTemplateData("remark", "歡迎再次光臨！")
        );
        templateMessage.setData(data);
        try {
            wxMpService.getTemplateMsgService().sendTemplateMsg(templateMessage);
        }catch (WxErrorException e) {
            log.error("【微信模版消息】發送失敗, {}", e);
        }
    }
}

 

3、在訂單完結時推送這個消息，故在OrderServiceImpl上的finish方法上推送微信模板消息

注意：在PushMessageServiceImpl上若是消息推送發生錯誤，只是用log標記一下而已，並無拋出異常，這個由於它在OrderServiceImpl.finish

上被引用，若是拋出異常，那麼整個方法就會由於@Transactial註解不經過。