微信公众号发送模板消息

---

1 开发中遇到的问题汇总

首先是在测试中,遇到最多的就是41003->appid错误,然后就是40165,说什么page和pagepath,其实就是线上和体验的问题,反正不管怎么改发出去就行,跳转到正确的页面即可,但是大问题是:公众号的文档然后里面发送模板消息是小程序的,然后一直就是appid错误,然后突然发现还有个文档,修改body后测试成功.按照我的方式是肯定成功的,因为有的博客都是从官方文档抄一遍测都不测.

2 模板消息创建

3 调试接口

3.1 微信公众号消息模板

3.1.1 基本信息

• 接口状态： 开发中
• 接口URL： https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=49_pWR_MJBhGBi97IMi0pzXqkxphglh9YzKPs8Wu962QjtVeVL1MbnTLHTL11mUMPFrhJMjPTB6OGvmzcs9w1MJG8xQVbhFalmh5K7WtOHLR7pQDhupwLCKkQGrqsb8sy-OIAkDr2CzWtQVlBOIRTNdAGAEGA
• 请求方式： POST
• Content-Type： application/json

3.2 请求参数

3.2.1 Query参数及说明

参数名	示例值	参数类型	是否必填	参数描述
access_token	49_pWR_MJBhGBi97IMi0pzXqkxphglh9YzKPs8Wu962QjtVeVL1MbnTLHTL11mUMPFrhJMjPTB6OGvmzcs9w1MJG8xQVbhFalmh5K7WtOHLR7pQDhupwLCKkQGrqsb8sy-OIAkDr2CzWtQVlBOIRTNdAGAEGA		是	暂无描述

3.2.2 body参数及说明

{
	"touser": "oUtXT6JTkW8oeQbRb-wBe9CMucyU",
	"template_id": "Eeh7tc4SiJ9W49QSyjTeuCgscRTjBq_DEmf1BNmq_VU",
	"url": "http://weixin.qq.com/download",
	"topcolor": "#FF0000",
	"data": {
		"first": {
			"value": "恭喜你购买成功！",
			"color": "#173177"
		},
		"keyword1": {
			"value": "巧克力",
			"color": "#173177"
		},
		"keyword2": {
			"value": "39.8元",
			"color": "#173177"
		},
		"keyword3": {
			"value": "2014年9月22日",
			"color": "#173177"
		},
		"remark": {
			"value": "欢迎再次购买！",
			"color": "#173177"
		}
	}
}

4 测试结果

其实开发过程中并不是很复杂,只是文档有一些问题,容易歧义

5 工具类封装

// 获取token
        String token = saveAndFlushAccessTokenUtil.getToken();
 
        String postUrl = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" + token;
 
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("touser", "发送到用户的openid");   // openid
        jsonObject.put("template_id", "你的模板id");
        jsonObject.put("url", "http://www.baidu.com");
 
        JSONObject data = new JSONObject();
        JSONObject first = new JSONObject();
        first.put("value", "hello");
        first.put("color", "#173177");
        JSONObject keyword1 = new JSONObject();
        keyword1.put("value", "hello");
        keyword1.put("color", "#173177");
        JSONObject keyword2 = new JSONObject();
        keyword2.put("value", "hello");
        keyword2.put("color", "#173177");
        JSONObject keyword3 = new JSONObject();
        keyword3.put("value", "hello");
        keyword3.put("color", "#173177");
        JSONObject remark = new JSONObject();
        remark.put("value", "hello");
        remark.put("color", "#173177");
        
        data.put("first",first);
        data.put("keyword1",keyword1);
        data.put("keyword2",keyword2);
        data.put("keyword3",keyword3);
        data.put("remark",remark);
 
        jsonObject.put("data", data);
 
        String string = HttpClientUtils.sendPostJsonStr(postUrl, jsonObject.toJSONString());
        JSONObject result = JSON.parseObject(string);
        int errcode = result.getIntValue("errcode");
        if(errcode == 0){
            // 发送成功
            System.out.println("发送成功");
        } else {
            // 发送失败
            System.out.println("发送失败");
        }

6 常见问题

有时候你会发现你的jsonobject中进行转字符串会被转义,然后发出去的模板消息读不到内容,可能是因为你放入的Json字符串,之后又进行了一次jsonObject.toJSONString(),之后就被转义了,建议就是把所有的Json放入到一个jsonObject,最后合并时在进行jsonObject.toJSONString().

以下为测试代码:最终的话被转义的内容是空白!

  @ApiOperation(value = "测试发送微信公众模板消息", notes = "测试发送微信公众模板消息")
    @GetMapping("/sendMsg")
    public ResponseEntity sendMsg() throws ApiException {
        com.alibaba.fastjson.JSONObject jsonObject=new com.alibaba.fastjson.JSONObject();
        com.alibaba.fastjson.JSONObject jsonObjectValue = new com.alibaba.fastjson.JSONObject();
        jsonObjectValue.put("value","oldlu");
        jsonObjectValue.put("color","#173177");
        com.alibaba.fastjson.JSONObject firstValue = new com.alibaba.fastjson.JSONObject();
        firstValue.put("value","oldlu");
        firstValue.put("color","#173177");
        jsonObject.put("first",firstValue.toJSONString());
        com.alibaba.fastjson.JSONObject keyword1Value = new com.alibaba.fastjson.JSONObject();
        keyword1Value.put("value","oldlu");
        keyword1Value.put("color","#173177");
        jsonObject.put("keyword1",keyword1Value.toString());
        com.alibaba.fastjson.JSONObject keyword2Value = new com.alibaba.fastjson.JSONObject();
        keyword2Value.put("value","oldlu");
        keyword2Value.put("color","#173177");
        jsonObject.put("keyword2",keyword2Value);
        com.alibaba.fastjson.JSONObject keyword3Value = new com.alibaba.fastjson.JSONObject();
        keyword3Value.put("value","oldlu");
        keyword3Value.put("color","#173177");
        jsonObject.put("keyword3",keyword3Value);
        com.alibaba.fastjson.JSONObject remarkValue = new com.alibaba.fastjson.JSONObject();
        remarkValue.put("value","oldlu");
        remarkValue.put("color","#173177");
        jsonObject.put("remark",remarkValue);
        JSONObject jsonResponse= WeChatMpUtil.sendTemplate("oUtXT6DbS3tA_eeMaUVZvN66ezTs", "Eeh7tc4SiJ9W49QSyjTeuCgscRTjBq_DEmf1BNmq_VU", jsonObject, "http://www.baidu.com/");
        return ResponseEntity.ok(jsonResponse);
    }

toString和toJsonString其实是一样(源码)：