狼山资源网

微信公众平台 发送模板消息(Java接口开发)
网络编程 2024/11/8 佚名
3 2

前言：最近一直再弄微信扫码推送图文消息和模板消息发送，感觉学习到了不少东西。今天先总结一下微信公众平台模板消息的发送。因为这个自己弄了很久，开始很多地方不明白，所以今天好好总结一下。

微信公众平台技术文档：模板消息接口

一、概述

模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。

关于使用规则，请注意：

1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限；
2、需要选择公众账号服务所处的2个行业，每月可更改1次所选行业；
3、在所选择行业的模板库中选用已有的模板进行调用；
4、每个账号可以同时使用25个模板。
5、当前每个账号的模板消息的日调用上限为10万次，单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时，模板消息的日调用上限会相应提升，以公众号MP后台开发者中心页面中标明的数字为准。

关于接口文档，请注意：

1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容；
2、模板中参数内容必须以”.DATA”结尾，否则视为保留字；
3、模板保留符号”{{ }}”。

看微信公众平台接口文档最开始我的内心是崩溃的，因为目录列表一开始就是设置所属行业，获取所属行业信息等。后来整理思路，我们主要负责的功能的实现，就不去考虑那么多其他的内容，直接弄模板消息的发送。但是发送模板之前有一个很重要的步骤，就是模板ID（template_id）。微信公众平台发送模板消息有严格的要求，参考模板消息运营规范。

二、模板消息的设计

这里是依靠微信公众平台测试公众号的模板消息接口来设计消息模板，通过行业类型来获取模板的同学还是参考微信公众平台的官方文档来学习。

1 新增模板消息

微信公众平台 发送模板消息(Java接口开发)

微信的测试公众号为我们提供了测试的消息模板，最多可添加10个（感觉够用，毕竟只是测试），新增测试模板。

微信公众平台 发送模板消息(Java接口开发)

（1）添加模板标题和模板内容

微信公众平台 发送模板消息(Java接口开发) 

模板标题比较好理解，模板内容需要设计参数，参数需以{{开头，以.DATA}}结尾。

例如：{{first.DATA}}

first就是我们接口传的参数。

{{first.DATA}} 
商品：{{keynote1.DATA}} 
价格：{{keynote2.DATA}} 
日期：{{keynote3.DATA}} 
{{remark.DATA}}

新增之后就可以看到模板记录，就有我们需要的模板ID了。有了模板ID我们就可以按照接下来的微信公众平台发送模板消息接口来实现我们的功能。

微信公众平台 发送模板消息(Java接口开发)

三、发送模板消息

1 接口调用请求说明

http请求方式: POST

https://api.weixin.qq.com/cgi-bin/message/template/send"htmlcode"> 

 {
      "touser":"OPENID",
      "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
      "url":"http://weixin.qq.com/download", 
      "miniprogram":{
       "appid":"xiaochengxuappid12345",
       "pagepath":"index"
      },     
      "data":{
          "first": {
            "value":"恭喜你购买成功！",
            "color":"#173177"
          },
          "keynote1":{
            "value":"巧克力",
            "color":"#173177"
          },
          "keynote2": {
            "value":"39.8元",
            "color":"#173177"
          },
          "keynote3": {
            "value":"2014年9月22日",
            "color":"#173177"
          },
          "remark":{
            "value":"欢迎再次购买！",
            "color":"#173177"
          }
      }
    }

3 参数说明

参数 是否必填 说明、 touser 是 接收者openid template_id 是 模板ID url 否 模板跳转链接 miniprogram 否 跳小程序所需数据，不需跳小程序可不用传该数据 appid 是 所需跳转到的小程序appid（该小程序appid必须与发模板消息的公众号是绑定关联关系） pagepath 是 所需跳转到小程序的具体页面路径，支持带参数,（示例index"htmlcode"> 

public class TemplateData { 

  private String value; 
  private String color; 

  public String getValue() { 
    return value; 
  } 

  public void setValue(String value) { 
    this.value = value; 
  } 

  public String getColor() { 
    return color; 
  } 

  public void setColor(String color) { 
    this.color = color; 
  } 
}
public class WechatTemplate { 

  private String touser; 

  private String template_id; 

  private String url; 

  private Map<String, TemplateData> data; 

  public String getTouser() { 
    return touser; 
  } 

  public void setTouser(String touser) { 
    this.touser = touser; 
  } 

  public String getTemplate_id() { 
    return template_id; 
  } 

  public void setTemplate_id(String template_id) { 
    this.template_id = template_id; 
  } 

  public String getUrl() { 
    return url; 
  } 

  public void setUrl(String url) { 
    this.url = url; 
  } 

  public Map<String, TemplateData> getData() { 
    return data; 
  } 

  public void setData(Map<String, TemplateData> data) { 
    this.data = data; 
  } 
}

（2）发送模板消息方法

public class TemplateMessageServiceImpl implements TemplateMessageService{

  private RestTemplate restTemplate ; 

  private String serviceHost = "https://api.weixin.qq.com";

  public TemplateMessageServiceImpl() {
    restTemplate = RestTemplateFactory.makeRestTemplate();
  }

  @Override
  public WeixinResponse sendTemplateMessage(String accessToken, WeixinTemplate weixinTemplate) {
    WeixinResponse weixinResponse = null;
    String url = new StringBuffer(serviceHost).append("/cgi-bin/message/template/send")
        .append(accessToken).toString();
    weixinResponse = restTemplate.postForObject(url, weixinTemplate, WeixinResponse.class,new HashMap<String,String>());
    return weixinResponse;
  }

}

说明：简单理解模板消息发送，首先是获取accessToken，（如何获取请参考：微信公众平台 获取access_token）。其次是模板消息的参数封装，最后就是http的post请求。我的http请求是使用Spring的restTemplate进行请求，就不用我单独写一个http请求方法，如果没有使用可以写一个http请求的工具类。

（3）封装响应参数Demo

package com.plateno.weixin.message.model;

public class WeixinResponse {
  private String msgid;
  private int errcode;
  private String errmsg;

  public String getMsgid() {
    return msgid;
  }
  public void setMsgid(String msgid) {
    this.msgid = msgid;
  }
  public int getErrcode() {
    return errcode;
  }
  public void setErrcode(int errcode) {
    this.errcode = errcode;
  }
  public String getErrmsg() {
    return errmsg;
  }
  public void setErrmsg(String errmsg) {
    this.errmsg = errmsg;
  }

  @Override
  public String toString() {
    StringBuffer buf = new StringBuffer("WeixinResponse[msgid=");
    buf.append(msgid)
    .append(",errcode=").append(errcode)
    .append(",errmsg=").append(errmsg)
    .append("]");
    return buf.toString();
  }

}

模板消息发送效果：

微信公众平台 发送模板消息(Java接口开发)

四、事件推送

在模版消息发送任务完成后，微信服务器会将是否送达成功作为通知，发送到开发者中心中填写的服务器配置地址中。

1 送达成功时

（1）推送的XML如下

 <xml>
      <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
      <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
      <CreateTime>1395658920</CreateTime>
      <MsgType><![CDATA[event]]></MsgType>
      <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
      <MsgID>200163836</MsgID>
      <Status><![CDATA[success]]></Status>
      </xml>

（2）参数说明

参数 说明 ToUserName 公众号微信号 FromUserName 接收模板消息的用户的openid CreateTime 创建时间 MsgType 消息类型是事件 Event 事件为模板消息发送结束 MsgID 消息id Status 发送状态为成功

 2 送达由于用户拒收（用户设置拒绝接收公众号消息）而失败时

（1）推送的XML如下

  <xml>
      <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
      <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
      <CreateTime>1395658984</CreateTime>
      <MsgType><![CDATA[event]]></MsgType>
      <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
      <MsgID>200163840</MsgID>
      <Status><![CDATA[failed:user block]]></Status>
      </xml>

（2）参数说明

参数 说明 ToUserName 公众号微信号 FromUserName 接收模板消息的用户的openid CreateTime 创建时间 MsgType 消息类型是事件 Event 事件为模板消息发送结束 MsgID 消息id Status 发送状态为用户拒绝接收

3 送达由于其他原因失败时

（1）推送的XML如下

 <xml>
      <ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
      <FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
      <CreateTime>1395658984</CreateTime>
      <MsgType><![CDATA[event]]></MsgType>
      <Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
      <MsgID>200163840</MsgID>
      <Status><![CDATA[failed: system failed]]></Status>
      </xml>

（2）参数说明

参数 说明 ToUserName 公众号微信号 FromUserName 接收模板消息的用户的openid CreateTime 创建时间 MsgType 消息类型是事件 Event 事件为模板消息发送结束 MsgID 消息id Status 发送状态为发送失败（非用户拒绝）

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

标签：
微信公众平台,发送模板消息
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
狼山资源网 Copyright www.pvsay.com
www.pvsay.com 狼山资源网
29,905影音资源
44,626技术资源
11,817软件资源
578,645站长资源

友情链接

杰晶网络 DDR爱好者之家 桃源资源网 杰网资源 富贵资源网 南强小屋 铁雪资源网 幽灵资源网 万梅资源网 狼山资源网 白云岛资源网 昆仑资源网 相思资源网 明霞山资源网 内蒙古资源网 黑松山资源网 茶园资源网 饿虎岗资源网 大旗谷资源网 常春岛资源网 岱庙资源网 兴国资源网 快活林资源网 蝙蝠岛资源网 帝王谷资源网 白云城资源网 伏龙阁资源网 清风细雨楼 天枫庄资源网 圆月山庄资源网 无争山庄资源网 神水资源网 移花宫资源网 神剑山庄资源网 无为清净楼资源网 金钱帮资源网 丐帮资源网 华山资源网 极乐门资源网 小李飞刀资源网 凤求凰客栈 风云阁资源网 金狮镖局 鸳鸯亭资源网 千金楼资源网 更多链接
狼山资源网 Copyright www.pvsay.com