微信公众号-推送模板消息

模板消息文档

公众号的类型分为服务号、订阅号和企业号,其中服务号和订阅号比较常见。要想实现公众号推动消息给指定的用户,其类型必须为服务号。

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

模板消息Demo-正式

设置模板消息

此处为正式环境的设置,开发环境可使用微信测试平台提供的测试账号体验和测试公众平台的所有高级接口,无需提前申请审核,详情见本文最后章节。

首次设置需要开启模板消息功能,登录公众号后台: mp.weixin.qq.com ,在左侧导航栏最下方有「添加新的功能」,打开,在「广告与服务」一类中找到「模板消息」,开通即可。

打开「模板消息」,选择模板库,需先选择所在行业(一个月只能修改一次),之后在下方的行业模板中选择合适的模板(可以搜索模板关键字)。

在这里插入图片描述

添加完选择的模板后在「我的模板」中可以查看模板的详细信息,此处的模板ID后面代码中会用到。

在这里插入图片描述

编码

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}}
        // 订单编号:{{keyword1.DATA}}
        // 订货终端:{{keyword2.DATA}}
        // 下单时间:{{keyword3.DATA}}
        // {{remark.DATA}}
        String OrderMsgTemplateId = "Th5MwuyqSjfADUDOJ5PSGDf1swr1-nHmOtLYlVX8n_8";

        // 卡片详情跳转页,设置此值,当点击消息时会打开指定的页面
//        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 需和模板消息对应
        List<WxMpTemplateData> wxMpTemplateDataList = Arrays.asList(
                new WxMpTemplateData("first", "您有一个新的订货单", "#000000"),
                new WxMpTemplateData("keyword1", orderId),
                new WxMpTemplateData("keyword2", serviceName),
                new WxMpTemplateData("keyword3", timeNow),
                new WxMpTemplateData("remark", "请登录系统查看订单详情并及时配货")
        );

        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. 配置参数

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 = "";		// 发送给指定的用户
    String serviceName = "";
    String orderNo = "";
    
    SubscriptionMessage.sendOrderMsg(APPID, APP_SECRET, openid, orderNo, serviceName);
  }
  
}

微信测试号

开发过程中直接使用正式微信号、公众号可能会有诸多不便,所以微信公众平台提供接口测试账号,可直接体验和测试公众平台所有高级接口。

地址: 微信公众平台测试账号

登录后可查看测试账号的 appid、appsecret

在这里插入图片描述

可以使用微信扫描页面下方的测试公众号二维码关注,关注后可获取当前微信号的测试 openid(非公众账号的 openid),可用于代码中临时指定模板消息接收用户,方便开发。

在这里插入图片描述

该测试平台还提供测试用模板消息,可自定义模板消息,创建完成后会临时生成模板 ID ,代码中直接替换即可。

在这里插入图片描述

接收消息示例如下:

接收消息 demo
### 实现微信公众号向多人推送消息的方法 #### 准备工作 为了实现微信公众号向多个用户推送消息,需先完成一系列准备工作。这包括但不限于获取`APPID`和`AppSecret`,这是微信公众平台分配给开发者的唯一标识符和密钥[^1]。 #### 配置服务器端环境 采用Spring Boot框架构建应用时,需要将该应用程序部署至服务器,并将其URL设置为微信公众号的回调地址。此步骤确保了微信服务器能够与自定义的应用程序交互,从而接收并处理来自用户的请求以及执行后续的消息推送逻辑[^5]。 #### 获取Access Token 由于每次调用微信API都需要有效的access_token作为凭证,在实际编码前应编写一段用于定期刷新token值的服务代码片段: ```java public String getAccessToken(String appid, String secret){ RestTemplate restTemplate = new RestTemplate(); Map<String,Object> params = new HashMap<>(); params.put("grant_type","client_credential"); params.put("appid",appid); params.put("secret",secret); ResponseEntity<JsonNode> responseEntity = restTemplate.getForEntity( "https://api.weixin.qq.com/cgi-bin/token?grant_type={grant_type}&appid={appid}&secret={secret}", JsonNode.class, params ); return Objects.requireNonNull(responseEntity.getBody()).get("access_token").asText(); } ``` 上述函数利用HTTP GET方式访问官方提供的认证接口以换取最新令牌[^3]。 #### 查询订阅者列表 要针对特定群体实施批量通知,则必须事先收集目标受众的信息——即他们的OpenIDs(每个用户对于不同应用所对应的唯一身份码)。可以通过如下所示的方式取得已关注当前账号下的所有成员数据: ```java private List<String> getUserList(String accessToken) { RestTemplate restTemplate = new RestTemplate(); ResponseEntity<JsonNode> responseEntity = restTemplate.getForEntity( "https://api.weixin.qq.com/cgi-bin/user/get?access_token=" + accessToken, JsonNode.class ); ArrayNode dataArray = (ArrayNode)responseEntity.getBody().get("data").get("openid"); Iterator<JsonNode> elements = dataArray.elements(); ArrayList<String> openIds = new ArrayList<>(); while(elements.hasNext()){ openIds.add(elements.next().toString().replaceAll("\"", "")); } return openIds; } ``` 这段脚本会返回一个包含所有有效订阅者的集合对象,便于之后筛选出符合条件的对象进行个性化沟通[^2]。 #### 发送模板消息 最后一步就是设计具体的推送内容形式。如果希望发送带有固定格式的通知类信息,则推荐使用预设好的模板样式。创建好所需模版后,按照下述模式填充变量部分并向选定收件人群体分发: ```java private void sendMassMessage(List<String> toUsers, String templateId, String access_token) throws Exception{ ObjectMapper mapper = new ObjectMapper(); ObjectNode rootNode = mapper.createObjectNode(); ArrayNode touserArr = mapper.createArrayNode(); for (String user : toUsers) { touserArr.add(user); } rootNode.set("touser", touserArr); rootNode.put("template_id", templateId); // 假定存在名为first、keyword1...等字段名对应于具体文案位置 ObjectNode dataObj = mapper.createObjectNode(); ObjectNode firstData = mapper.createObjectNode(); firstData.put("value", "尊敬的客户您好!"); dataObj.set("first", firstData); // 继续添加其他关键词... rootNode.set("data", dataObj); HttpEntity<String> requestEntity = new HttpEntity<>(rootNode.toString()); RestTemplate restTemplate = new RestTemplate(); ResponseEntity<String> exchangeResult = restTemplate.exchange( "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token="+access_token, HttpMethod.POST, requestEntity, String.class ); } ``` 以上流程展示了如何基于Java编程语言配合Spring Boot微服务架构搭建一套完整的微信公共号多用户消息广播机制[^4]。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值