微信公众平台开发(4) 微信模板消息接口 - 柳絮拂面

时间:2024-02-19 07:51:24

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

一、添加消息模板

     1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口,但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限;

     2、需要选择公众账号服务所处的2个行业

     3、在所选择行业的模板库中添加模板;

     4、在我的模板中可以看到添加的模板(商家新订单提醒模板)

 

二、模板消息接口开发

     access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token,access_token的有效期是2小时。

     模板消息需要使用access_token来授权。

     1、获取access_token

      接口地址:https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

      请求方式:GET

      返回的数据格式:json格式

 1 public  String getAccessToken(){  
 2             String requestUrl = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";
 3             
 4             String appid = "appid";//第三方用户唯一凭证
 5             
 6             String secret = "appsecret";//    第三方用户唯一凭证密钥,即appsecret
 7             
 8             requestUrl=requestUrl.replace("APPID", appid);  
 9             requestUrl=requestUrl.replace("APPSECRET", secret);
10             
11             JSONObject jsonObject= CommonUtil.httpsRequestToJsonObject(requestUrl, "GET", null, false); 
12             
13             String access_token = jsonObject.getString("access_token");
14         
15         return access_token;
16           
17     } 

2、模板

     

 1 public class Template {  
 2   
 3     // 消息接收方  
 4     private String toUser;  
 5     // 模板id  
 6     private String templateId;  
 7     // 模板消息详情链接  
 8     private String url;  
 9     // 消息顶部的颜色  
10     private String topColor;  
11     // 参数列表  
12     private List<TemplateParam> templateParamList;  
13     //省略getter、setter方法
14     
15     //按微信接口要求格式化模板
16     public String toJSON() {  
17         StringBuffer buffer = new StringBuffer();  
18         buffer.append("{");  
19         buffer.append(String.format("\"touser\":\"%s\"", this.toUser)).append(",");  
20         buffer.append(String.format("\"template_id\":\"%s\"", this.templateId)).append(",");  
21         buffer.append(String.format("\"url\":\"%s\"", this.url)).append(",");  
22         buffer.append(String.format("\"topcolor\":\"%s\"", this.topColor)).append(",");  
23         buffer.append("\"data\":{");  
24         TemplateParam param = null;  
25         for (int i = 0; i < this.templateParamList.size(); i++) {  
26              param = templateParamList.get(i);  
27             // 判断是否追加逗号  
28             if (i < this.templateParamList.size() - 1){  
29                   
30                 buffer.append(String.format("\"%s\": {\"value\":\"%s\",\"color\":\"%s\"},", param.getName(), param.getValue(), param.getColor()));  
31             }else{  
32                 buffer.append(String.format("\"%s\": {\"value\":\"%s\",\"color\":\"%s\"}", param.getName(), param.getValue(), param.getColor()));  
33             }  
34           
35         }  
36         buffer.append("}");  
37         buffer.append("}");  
38         return buffer.toString();  
39     }  
40 }

3、发送模板消息,返回json格式结果

public  JSONObject  sendTemplateMsg(Template template){  
        
        //获取token
        String token = accessTokenService.getAccessToken();
          
        String requestUrl = "https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN";
        
        requestUrl=requestUrl.replace("ACCESS_TOKEN", token);  
        
        if (log.isDebugEnabled()) {
            log.debug(template.toJSON());
        }
        //发送模板消息,返回json格式结果
        JSONObject jsonObject = CommonUtil.httpsRequestToJsonObject(requestUrl, "POST", template.toJSON(),false);  
        
        return jsonObject;
          
          
    } 

三、实现效果

     以订单支付成功通知为例:

    构造消息实体:

 1         String tplId = "whmJQfErBz_62Fu4ebCiDkz4u9hgBJOMolbLEwZDvh4";
 2         Template tem=new Template();  
 3         tem.setTemplateId(tplId);  
 4         tem.setTopColor(SUCCESS_TOP_COLOR);  
 5                   
 6         List<TemplateParam> paras=new ArrayList<TemplateParam>();  
 7         paras.add(new TemplateParam("first","您有一笔新订单,等待发货。","#333"));  
 8         paras.add(new TemplateParam("keyword1","T16081000152","#333"));
 9         paras.add(new TemplateParam("keyword2","白菜套餐*1","#333"));
10         paras.add(new TemplateParam("keyword3","9.00元","#333"));
11         paras.add(new TemplateParam("keyword4","余额支付","#333"));
12         paras.add(new TemplateParam("keyword5","零零壹、12345678901","#333"));
13         paras.add(new TemplateParam("remark","请及时处理,感谢你对云农批的支持!!!","#333"));  
14                   
15         tem.setTemplateParamList(paras);  
16         tem.setToUser("openid");//用户openid
17         //设置超链接
18         tem.setUrl(WeixinConfig.getInstance().getYnp_url());  
19 
20         
21         JSONObject jsonObject = sendTemplateMsg(tem);

 

    实现效果: