快捷導(dǎo)航

微信公眾號(hào)服務(wù)號(hào)推送模板消息設(shè)置方法(后端java)

更新時(shí)間：2023年02月21日 14:07:00 作者：TaoCap

公眾號(hào)時(shí)經(jīng)常會(huì)需要寫推送消息,從網(wǎng)上找了一大堆,都不是很全,所以這篇文章主要介紹了微信公眾號(hào)服務(wù)號(hào)推送模板消息設(shè)置方法的相關(guān)資料,需要的朋友可以參考下

推送的模板消息示例如下：

模板消息Demo-正式

設(shè)置模板消息

此處為正式環(huán)境的設(shè)置，開發(fā)環(huán)境可使用微信測(cè)試平臺(tái)提供的測(cè)試賬號(hào)體驗(yàn)和測(cè)試公眾平臺(tái)的所有高級(jí)接口，無(wú)需提前申請(qǐng)審核，詳情見(jiàn)本文最后章節(jié)。

首次設(shè)置需要開啟模板消息功能，登錄公眾號(hào)后臺(tái)： mp.weixin.qq.com ，在左側(cè)導(dǎo)航欄最下方有「添加新的功能」，打開，在「廣告與服務(wù)」一類中找到「模板消息」，開通即可。

打開「模板消息」，選擇模板庫(kù)，需先選擇所在行業(yè)（一個(gè)月只能修改一次），之后在下方的行業(yè)模板中選擇合適的模板（可以搜索模板關(guān)鍵字）。

添加完選擇的模板后在「我的模板」中可以查看模板的詳細(xì)信息，此處的模板ID后面代碼中會(huì)用到。

編碼

1. 添加依賴

// Gradle
dependencies {
	// ...
	compile "com.github.binarywang:weixin-java-mp:3.3.0"
	// ...
}


// Maven
<dependency>
  <groupId>com.github.binarywang</groupId>
  <artifactId>weixin-java-mp</artifactId>
  <version>3.0.0</version>
</dependency>

2. SubscriptionMessageUtil.java

import me.chanjar.weixin.mp.api.WxMpInMemoryConfigStorage;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.api.impl.WxMpServiceImpl;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateData;
import me.chanjar.weixin.mp.bean.template.WxMpTemplateMessage;

import java.text.SimpleDateFormat;
import java.util.Arrays;
import java.util.Date;
import java.util.List;

public class SubscriptionMessageUtil {

    /**
     * 下單后通知供貨商
     */
    public static void sendOrderMsg(String appid,
                                    String appSecret,
                                    String userOpenid,
                                    String orderId,
                                    String serviceName) {

        // 模板消息 ID
        // {{first.DATA}}
        // 訂單編號(hào)：{{keyword1.DATA}}
        // 訂貨終端：{{keyword2.DATA}}
        // 下單時(shí)間：{{keyword3.DATA}}
        // {{remark.DATA}}
        String OrderMsgTemplateId = "Th5MwuyqSjfADUDOJ5PSGDf1swr1-nHmOtLYlVX8n_8";

        // 卡片詳情跳轉(zhuǎn)頁(yè)，設(shè)置此值，當(dāng)點(diǎn)擊消息時(shí)會(huì)打開指定的頁(yè)面
//        String detailUrl = "https://bing.com";

        SimpleDateFormat sdf = new SimpleDateFormat();
        sdf.applyPattern("yyyy-MM-dd HH:mm");
        Date date = new Date();
        String timeNow = sdf.format(date);

        WxMpInMemoryConfigStorage wxStorage = new WxMpInMemoryConfigStorage();
        wxStorage.setAppId(appid);
        wxStorage.setSecret(appSecret);

        WxMpService wxMpService = new WxMpServiceImpl();
        wxMpService.setWxMpConfigStorage(wxStorage);

      	// 此處的 key/value 需和模板消息對(duì)應(yīng)
        List<WxMpTemplateData> wxMpTemplateDataList = Arrays.asList(
                new WxMpTemplateData("first", "您有一個(gè)新的訂貨單", "#000000"),
                new WxMpTemplateData("keyword1", orderId),
                new WxMpTemplateData("keyword2", serviceName),
                new WxMpTemplateData("keyword3", timeNow),
                new WxMpTemplateData("remark", "請(qǐng)登錄系統(tǒng)查看訂單詳情并及時(shí)配貨")
        );

        WxMpTemplateMessage templateMessage = WxMpTemplateMessage.builder()
                .toUser(userOpenid)
                .templateId(OrderMsgTemplateId)
                .data(wxMpTemplateDataList)
//                .url(detailUrl)
                .build();

        try {
            wxMpService.getTemplateMsgService().sendTemplateMsg(templateMessage);
        } catch (Exception e) {
            System.out.println("推送失?。? + e.getMessage());
        }

    }

}

3. 配置參數(shù)

xx.properties

wx:
  mp:
    appid: xxx
    appSecret: xxx

4. 使用

在需要的 Controller 中直接引用即可

@Controller
@RequestMapping("/order")
public class XXController {
  
	@Value("${wx.mp.appid}")
	private String APPID;

	@Value("${wx.mp.appSecret}")
	private String APP_SECRET;
  
  @RequestMapping(value = "/create", method = RequestMethod.POST)
  public CommonResult create() {
    
    String openid = "";		// 發(fā)送給指定的用戶
    String serviceName = "";
    String orderNo = "";
    
    SubscriptionMessage.sendOrderMsg(APPID, APP_SECRET, openid, orderNo, serviceName);
  }
  
}