微信公众号给微信用户推送信息模板信息

最新推荐文章于 2025-05-29 12:18:25 发布

原创最新推荐文章于 2025-05-29 12:18:25 发布 · 1.2k 阅读

2 ·

CC 4.0 BY-SA版权

Java 专栏收录该内容

29 篇文章

订阅专栏

该功能主要是用于利用微信公众号向微信用户推送与用户相关的信息，在开发此功能之前需要获取到微信公众号的access_token，以及微信公众号的模板id
为了保证用户不受到骚扰，在开发者出现需要主动提醒、通知用户时，才允许开发者在公众平台网站中模版消息库中选择模版，选择后获得模版ID，再根据模版ID向用户主动推送提醒、通知消息。

模版消息调用时主要需要模版ID和模版中各参数的赋值内容。请注意：

1.模版中参数内容必须以".DATA"结尾，否则视为保留字;

2.模版保留符号"{{ }}"

具体调用方法
第一步：获取模版ID

通过在模版消息功能的模版库中使用需要的模版，可以获得模版ID。

第二步：请求接口

请注意，URL置空，则在发送后，点击模版消息会进入一个空白页面（ios），或无法点击（android）。

POST请求

https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
请求包为一个json：

{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"topcolor":"#FF0000",
"data":{
"User": {
"value":"黄先生",
"color":"#173177"
},
"Date":{
"value":"06月07日 19时24分",
"color":"#173177"
},
"CardNumber":{
"value":"0426",
"color":"#173177"
},
"Type":{
"value":"消费",
"color":"#173177"
},
"Money":{
"value":"人民币260.00元",
"color":"#173177"
},
"DeadTime":{
"value":"06月07日19时24分",
"color":"#173177"
},
"Left":{
"value":"6504.09",
"color":"#173177"
}
}
}

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

1、送达成功时，推送的XML如下：

<![CDATA[gh_7f083739789a]]> <![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]&g; 1395658920 <![CDATA[event]]> <![CDATA[TEMPLATESENDJOBFINISH]]> 200163836 <![CDATA[success]]>

2、送达由于用户拒收（用户设置拒绝接收公众号消息）而失败时，推送的XML如下：

<![CDATA[gh_7f083739789a]]> <![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]> 1395658984 <![CDATA[event]]> <![CDATA[TEMPLATESENDJOBFINISH]]> 200163840 <![CDATA[failed:user block]]>

3、送达由于其他原因失败时，推送的XML如下：

<![CDATA[gh_7f083739789a]]> <![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]> 1395658984 <![CDATA[event]]> <![CDATA[TEMPLATESENDJOBFINISH]]> 200163840 <![CDATA[failed: system failed]]>

返回码说明
在调用模版消息接口后，会返回JSON数据包。正常时的返回JSON数据包示例：

{
“errcode”:0,
“errmsg”:“ok”,
“msgid”:200228332
}
错误时的返回JSON数据，形式类似，错误码请见本页下方返回码说明。

返回码说明
-1 系统繁忙
0 请求成功
40001 验证失败
40002 不合法的凭证类型
40003 不合法的OpenID
40004 不合法的媒体文件类型
40005 不合法的文件类型
40006 不合法的文件大小
40007 不合法的媒体文件id
40008 不合法的消息类型
40009 不合法的图片文件大小
40010 不合法的语音文件大小
40011 不合法的视频文件大小
40012 不合法的缩略图文件大小
40013 不合法的APPID
41001 缺少access_token参数
41002 缺少appid参数
41003 缺少refresh_token参数
41004 缺少secret参数
41005 缺少多媒体文件数据
41006 access_token超时
42001 需要GET请求
43002 需要POST请求
43003 需要HTTPS请求
44001 多媒体文件为空
44002 POST的数据包为空
44003 图文消息内容为空
45001 多媒体文件大小超过限制
45002 消息内容超过限制
45003 标题字段超过限制
45004 描述字段超过限制
45005 链接字段超过限制
45006 图片链接字段超过限制
45007 语音播放时间超过限制
45008 图文消息超过限制
45009 接口调用超过限制
46001 不存在媒体数据
47001 解析JSON/XML内容错误

代码示例

package com.cn.demo;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import com.cn.util.HttpUtil;
import com.cn.util.ToolUtil;

import cn.hutool.json.JSONObject;
import cn.hutool.setting.Setting;

public class WechatTest {
	
	public static void main(String[] args) throws Exception {
	    //将参数配置在一个文件中进行调用
		Setting setting = new Setting("微信公众号配置文件");
		Map<String, String> map = new HashMap<String, String>();
		map.put("appid", setting.getStr("appid"));
		map.put("grant_type","client_credential");
		map.put("secret", setting.getStr("app_secret"));
		String url = "https://api.weixin.qq.com/cgi-bin/token";//获取微信公众号ACCESS_TOKEN
		String ret = HttpUtil.post(url, map);
		//hutool
		JSONObject retJson=new JSONObject(ret);
		//alibaba
	    com.alibaba.fastjson.JSONObject jhsObject = com.alibaba.fastjson.JSONObject.parseObject(ret);
		System.out.println("token:"+retJson.getStr("access_token"));
		System.out.println("token:"+jhsObject.getString("access_token"));
		//推送模板信息
		String template_url = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token="+retJson.getStr("access_token");
		Map<String, Object> jsonMap = new HashMap<String, Object>();
		jsonMap.put("touser", open_id);
		jsonMap.put("template_id",模板id);
		jsonMap.put("topcolor","FF0000");
		jsonMap.put("url","http://www.baidu.com");
		Map<String, Object> datamap = new HashMap<String, Object>();
		datamap.put("first",new keyTest("您好，您的账户新产生一笔回收订单", "#173177"));
		datamap.put("模板参数1",new keyTest("M201506111539", "#173177"));
		datamap.put("模板参数2",new keyTest("张三", "#173177"));
		datamap.put("模板参数3",new keyTest("111111111111", "#173177"));
		datamap.put("模板参数4",new keyTest("222222", "#173177"));
		datamap.put("模板参数5",new keyTest("周六上午", "#173177"));
		datamap.put("remark",new keyTest("请尽快联系客户，更多订单详细信息请登录优易换后台！", "#173177"));
		
		jsonMap.put("data",datamap);
		String json=new JSONObject(jsonMap).toString();
		System.out.println(json);
		String sendRet = HttpUtil.post(template_url, json);
		
		System.out.println(sendRet);
		
	}

}

package com.cn.demo;

public class keyTest {
	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;
	}
	private String value;
	private String color;
	
	public keyTest(String value, String color) {
		super();
		this.value = value;
		this.color = color;
	}
	
}