5行程式碼實現微信小程式模版訊息推送 (含推送後臺和小程式原始碼)

coyan發表於2021-09-09

我們在做小程式開發時,訊息推送是不可避免的。今天就來教大家如何實現小程式訊息推送的後臺和前臺開發。原始碼會在文章末尾貼出來。

其實我之前有寫過一篇: 但是有同學反應這篇文章裡的程式碼太繁瑣,接入也比較麻煩。今天就來給大家寫個精簡版的,基本上只需要幾行程式碼,就能實現小程式模版訊息推送功能。

老規矩先看效果圖
圖片描述
這是我們最終推送給使用者的模版訊息。這是使用者手機微信上顯示的推送訊息截圖。

本節知識點

1,java開發推送後臺
2,springboot實現推送功能
3,小程式獲取使用者openid
4,小程式獲取fromid用來推送

先來看後臺推送功能的實現

只有下面一個簡單的PushController類,就可以實現小程式訊息的推送
圖片描述
再來看下PushController類,你沒看錯,實現小程式訊息推送,就需要下面這幾行程式碼就可以實現了。
圖片描述
由於本推送程式碼是用springboot來實現的,下面就來簡單的講下。我我們需要注意的幾點內容。
1,需要在pom.xml引入一個三方類庫(推送的三方類庫)
圖片描述
pom.xml的完整程式碼如下

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns=""
         xmlns:xsi=""
         xsi:schemaLocation=" ">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.5.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.qcl</groupId>
    <artifactId>wxapppush</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>wxapppush</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--微信小程式模版推送-->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-miniapp</artifactId>
            <version>3.4.0</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

其實到這裡我們java後臺的推送功能,就已經實現了。我們只需要執行springboot專案,就可以實現推送了。
下面貼出完整的PushController.java類。裡面註釋很詳細了。

package com.qcl.wxapppush;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

import cn.binarywang.wx.miniapp.api.WxMaService;
import cn.binarywang.wx.miniapp.api.impl.WxMaServiceImpl;
import cn.binarywang.wx.miniapp.bean.WxMaTemplateData;
import cn.binarywang.wx.miniapp.bean.WxMaTemplateMessage;
import cn.binarywang.wx.miniapp.config.WxMaInMemoryConfig;
import me.chanjar.weixin.common.error.WxErrorException;

/**
 * Created by qcl on 2019-05-20
 * 微信:2501902696
 * desc: 微信小程式模版推送實現
 */
@RestController
public class PushController {

    @GetMapping("/push")
    public String push(@RequestParam String openid, @RequestParam String formid) {
        //1,配置小程式資訊
        WxMaInMemoryConfig wxConfig = new WxMaInMemoryConfig();
        wxConfig.setAppid("wx7c54942dfc87f4d8");//小程式appid
        wxConfig.setSecret("5873a729c365b65ab42bb5fc82d2ed49");//小程式AppSecret

        WxMaService wxMaService = new WxMaServiceImpl();
        wxMaService.setWxMaConfig(wxConfig);

        //2,設定模版資訊(keyword1:型別,keyword2:內容)
        List<WxMaTemplateData> templateDataList = new ArrayList<>(2);
        WxMaTemplateData data1 = new WxMaTemplateData("keyword1", "獲取老師微信");
        WxMaTemplateData data2 = new WxMaTemplateData("keyword2", "2501902696");
        templateDataList.add(data1);
        templateDataList.add(data2);

        //3,設定推送訊息
        WxMaTemplateMessage templateMessage = WxMaTemplateMessage.builder()
                .toUser(openid)//要推送的使用者openid
                .formId(formid)//收集到的formid
                .templateId("eDZCu__qIz64Xx19dAoKg0Taf5AAoDmhUHprF6CAd4A")//推送的模版id(在小程式後臺設定)
                .data(templateDataList)//模版資訊
                .page("pages/index/index")//要跳轉到小程式那個頁面
                .build();
        //4,發起推送
        try {            wxMaService.getMsgService().sendTemplateMsg(templateMessage);
        } catch (WxErrorException e) {
            System.out.println("推送失敗:" + e.getMessage());
            return e.getMessage();
        }
        return "推送成功";
    }
}

看程式碼我們可以知道,我們需要做一些配置,需要下面資訊
1,小程式appid
2,小程式AppSecret(密匙)
3,小程式推送模版id
4,使用者的openid
5,使用者的formid(一個formid只能用一次)

下面就是小程式部分,來教大家如何獲取上面所需的5個資訊。

1,appid和AppSecret的獲取(登入小程式管理後臺)
圖片描述
2,推送模版id
圖片描述
3,使用者openid的獲取,可以看下面的這篇文章,也可以看原始碼,這裡不做具體講解

4,獲取formid
圖片描述
看官方文件,可以知道我們的formid有效期是7天,並且一個form_id只能使用一次,所以我們小程式端所需要做的就是儘可能的多拿些formid,然後傳個後臺,讓後臺存到資料庫中,這樣7天有效期內,想怎麼用就怎麼用了。

所以接下來要講的就是小程式開發怎麼儘可能多的拿到formid了

圖片描述
看下官方提供的,只有在表單提交時把report-submit設為true時才能拿到formid,比如這樣

  <form report-submit='true' >
   <button  form-type='submit'>獲取formid</button>
  </form>

所以我們就要在這裡下功夫了,既然只能在form元件獲取,我們能不能把我們小程式裡用到最多的地方用form來偽裝呢。

下面簡單寫個獲取formid和openid的完整示例,方便大家學習

效果圖
圖片描述
我們要做的就是點選獲取formid按鈕,可以獲取到使用者的formid和openid,正常我們開發時,是需要把openid和formid傳給後臺的,這裡簡單起見,我們直接用獲取到的formid和openid實現推送功能

下面來看小程式端的實現程式碼

1,index.wxml
圖片描述
2,index.js
圖片描述

到這裡我們小程式端的程式碼也實現了,接下來測試下推送。

formid:  6ee9ce80c1ed4a2f887fccddf87686eb
openid o3DoL0Uusu1URBJK0NJ4jD1LrRe0

圖片描述
可以看到我們用了上面獲取到的openid和formid做了一次推送,顯示推送成功
圖片描述
圖片描述

到這裡我們小程式訊息推送的後臺和小程式端都講完了。

這裡有兩點需要大家注意

1,推送的openid和formid必須對應。
2,一個formid只能用一次,多次使用會報一下錯誤。

{"errcode":41029,"errmsg":"form id used count reach limit hint: [ssun8a09984113]"}

程式設計小石頭,碼農一枚,非著名全棧開發人員。分享自己的一些經驗,學習心得,希望後來人少走彎路,少填坑。

這裡就不單獨貼出原始碼下載連結了,大家感興趣的話,可以私信我,或者在底部留言,我會把原始碼下載連結貼在留言區。

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/2236/viewspace-2822945/,如需轉載,請註明出處,否則將追究法律責任。

相關文章