微信公众平台开发-发送模板消息

雨点打透心脏的1/2处 2022-06-18 11:29 410阅读 0赞

[微信][Link 1]公众账号开发\-发送模板消息：

**内容概要**

本篇文章主要叙述如何在微信公众帐号上实现“发送模板消息开发”功能。包含json的封装与解析。

**何谓模板消息**

为了保证用户不受到骚扰，在开发者出现需要主动提醒、通知用户时，才允许开发者在公众平台网站中模板消息库中选择模板，选择后获得模板ID，再根据模板ID向用户主动推送提醒、通知消息。

注意：模板消息只能开发者主动向微信用户发送，不能有用户被动发起。

**寻找接口（数据源）**

开发者需向微信服务器发送post请求，并携带根据模板配装好的一个json包。

请求地址：

[https://api.weixin.qq.com/cgi-bin/message/template/send?access\_token=ACCESS\_TOKEN][https_api.weixin.qq.com_cgi-bin_message_template_send_access_token_ACCESS_TOKEN]

json格式：

参考微信接口文档https://mp.weixin.qq.com/advanced/tmplmsg?action=faq&token=663979174&lang=zh\_CN

**开发步骤**

1） 获取模板ID

2） 构造模版消息体并请求接口

**代码及实现**

获取模板id:

1、具有支付能力的公众号才可以使用模板消息进行服务。在微信公众平台的后台，依次进入“功能->添加功能插件->模版消息”，即可申请模版消息。

![Center][]

点击申请

![Center 1][]

申请时，选择2个和自己相关的两个行业即可。

![Center 2][]

提交并且申请通过后，可以在模版库中看到模版消息列表

![Center 3][]

进入想使用的模板，点击添加

![Center 4][]

添加后就存到“我的模板库”中了（每个账号可以最多可以添加10个模板到“我的模板库”中）

![Center 5][]

查看模版的详情，可以看到模版id及各项内容参数名。

![Center 6][]

不同的模版消息的内容结构不一样。这些id及字段名将在程序中使用到。

注意：如果模板库中没有你想使用的模板时，可以在模板库页面点击“帮助我们完善模板库”创建自己的消息模板，创建消息模板需要申请，审核通过后该模板将被添加到该行业的模板库中。每个账号每月只能申请3个模板。

![Center 7][]

点击帮助我们完善模板库

![Center 8][]

代码实现（[Java][]，建议将代码复制到Eclipse编辑器，看起来效果就不凌乱了）：

1、构造模板体（json包），以交易提醒模板为例，这里封装成一个TradingNotice类。构造该类时需传入接收者微信的openid、模板id、模板主体颜色、用户名。代码中采用LinkedHashMap是为了保证数据是以存入的顺序排序，从而保证json格式的结构不被打乱。

**import** java.util.LinkedHashMap;

**import** java.util.Map;

**public class**TradingNotice \{

**private**Map<String,Object>map;

**private**Map<String,Object>data;

**public** TradingNotice(Stringtouser, String template\_id, Stringurl, String topcolor,Stringuser) \{

map=**new**LinkedHashMap<String, Object>();

data=**new**LinkedHashMap<String, Object>();

LinkedHashMap<String,String>first=**new**LinkedHashMap<String,String>();

first.put("value","尊敬的" +user + "：\\n\\n您尾号为0426的招商银行卡最近有一笔交易([测试][Link 2])");

first.put("color","\#743A3A");

data.put("first",first);

LinkedHashMap<String,String>keyword1=**new**LinkedHashMap<String,String>();

keyword1.put("value","YXJ134953845");

keyword1.put("color","\#FF0000");

data.put("keyword1",keyword1);

LinkedHashMap<String,String>keyword2=**new**LinkedHashMap<String,String>();

keyword2.put("value","2014/08/18 13:18");

keyword2.put("color","\#C4C400");

data.put("keyword2",keyword2);

LinkedHashMap<String,String>keyword3=**new**LinkedHashMap<String,String>();

keyword3.put("value","1888888888");

keyword3.put("color","\#0000FF");

data.put("keyword3",keyword3);

LinkedHashMap<String,String>keyword4=**new**LinkedHashMap<String,String>();

keyword4.put("value","消费");

keyword4.put("color","\#008000");

data.put("keyword4",keyword4);

LinkedHashMap<String,String>keyword5=**new**LinkedHashMap<String,String>();

keyword5.put("value","26万元");

keyword5.put("color","\#008000");

data.put("keyword5",keyword5);

LinkedHashMap<String,String>remark=**new**LinkedHashMap<String,String>();

remark.put("value","\\n\\n截止2014/08/18 13:18您招商信用账户可用余额未20000元");

remark.put("color","\#000000");

data.put("remark",remark);

map.put("touser",touser);

map.put("template\_id",template\_id);

map.put("url",url);

map.put("topcolor",topcolor);

map.put("data",data);

**public** Map<String,Object> getMap() \{

**return** map;

**public void** setMap(Map<String,Object> map)\{

**this**.map =map;

**public** Map<String,Object> getDate() \{

**return** data;

**public void** setDate(Map<String,Object> date)\{

**this**.data =date;

2、方法create\_TN\_Json用来构造json包，方法getUserData用来获取关注者昵称，需传入客户的openid。方法getUserList用来获取微信关注者列表，将所有关注者的openid保存在一个ArrayList中。由于获取关注者列表一次只能获取1000个微信号，所以当关注者多余1000的时候循环调用方法getUserJson来获取所有关注者账号。

获取关注这列表可参考微信公众平台接口文档，地址[http://mp.weixin.qq.com/wiki/index.php?title=获取关注者列表][http_mp.weixin.qq.com_wiki_index.php_title]

方法send\_Json用来发送模板消息请求，必须采用post请求

**import** java.io.BufferedReader;

**import** java.io.InputStream;

**import** java.io.InputStreamReader;

**import** java.io.OutputStreamWriter;

**import** java[.NET][].HttpURLConnection;

**import** java[.Net][.NET].URL;

**import** java.util.ArrayList;

**import** java.util.Iterator;

**import** wx.sunl.menus.Get\_Token;

**import** wx.sunl.template.TradingNotice;

**import** net.sf.json.JSONObject;

**public class**Create\_Json \{

//获取交易提醒json;

**public static** JSONObjectcreate\_TN\_Json(String touser,String user)\{

JSONObjectjsonObject=**null**;

//模板id

Stringtemplate\_id="15Eox4OfGsjFYaVRwk9Dbos\_aaIkzveCkpG3AsnKqLA";

//点击模板后的链接地址

Stringurl="www.baidu.com";

//模板的主题颜色

Stringtopcolor="\#008000";

//构造json包

TradingNoticewn = **new** TradingNotice(touser,template\_id,url,topcolor,user);

jsonObject=JSONObject.*fromObject*(wn.getMap());

**return** jsonObject;

//入口;

**public static void** main(String\[\] args)\{

//检查access\_token是否过期，如果过期重新产生

//Get\_Token.TwoDate();

//调用getUserList获取关注者列表

ArrayList<String>users= *getUserList*();

**if**(users!=**null**)\{

Iterator<String>user=users.iterator();

JSONObjectjsonObject1=**null**;

Stringopen\_id= **null**;

StringuserName= **null**;

**while**(user.hasNext())\{

open\_id = user.next();

//调用getUserData获取关注者昵称

userName = *getUserData*(open\_id);

**if**(userName!=**null**)\{

//创建交易提醒json包;

jsonObject1 = Create\_Json.*create\_TN\_Json*(open\_id,userName);

//发送交易提醒模板消息;

*send\_Json*(jsonObject1.toString(),Get\_Token.*access\_token*);

//获取用户基本信息(UnionID机制);

**public static** StringgetUserData(String openid)\{

StringBuffer bufferRes =**new** StringBuffer();

String result=**null**;

**try** \{

URL realUrl = **new** URL("https://api.weixin.qq.com/cgi-bin/user/info?access\_token=" + Get\_Token.*access\_token* +"&openid=" + openid\+"&lang=zh\_CN");

HttpURLConnection conn = (HttpURLConnection)realUrl.openConnection();

// 请求方式

conn.setDoOutput(**true**);

conn.setDoInput(**true**);

conn.setRequestMethod("GET");

conn.setUseCaches(**false**);

conn.setInstanceFollowRedirects(**true**);

conn.setRequestProperty("Content-Type","application/json");

conn.connect();

// 获取URLConnection对象对应的输入流

InputStream in =conn.getInputStream();

BufferedReader read =**new** BufferedReader(**new** InputStreamReader(in,"UTF-8"));

String valueString =**null**;

**while** ((valueString=read.readLine())!=**null**)\{

bufferRes.append(valueString);

System.***out***.println(bufferRes);

in.close();

**if** (conn !=**null**)\{

// 关闭连接

conn.disconnect();

\} **catch** (Exceptione) \{

e.printStackTrace();

//将返回的字符串转换成json

JSONObject jsonObject = JSONObject.*fromObject*(bufferRes.toString());

//解析json中的数据

String subscribe = jsonObject.get("subscribe").toString();

//等于1表示有关注者，0表示没有关注者

**if**("1".equals(subscribe.toString()))\{

//解析出关注者的昵称

result = (String)jsonObject.get("nickname");

**return**result;

//获取关注列表;

@SuppressWarnings("unchecked")

**public static** ArrayList<String>getUserList() \{

StringBuffer bufferRes =**new** StringBuffer();

ArrayList<String> users =**null**;

**try** \{

URL realUrl = **new** URL("https://api.weixin.qq.com/cgi-bin/user/get?access\_token=" + Get\_Token.*access\_token*);

HttpURLConnection conn = (HttpURLConnection)realUrl.openConnection();

// 请求方式

conn.setDoOutput(**true**);

conn.setDoInput(**true**);

conn.setRequestMethod("GET");

conn.setUseCaches(**false**);

conn.setInstanceFollowRedirects(**true**);

conn.setRequestProperty("Content-Type","application/json");

conn.connect();

// 获取URLConnection对象对应的输入流

InputStream in =conn.getInputStream();

BufferedReader read =**new** BufferedReader(**new** InputStreamReader(in,"UTF-8"));

String valueString =**null**;

**while** ((valueString=read.readLine())!=**null**)\{

bufferRes.append(valueString);

System.***out***.println(bufferRes);

in.close();

**if** (conn !=**null**)\{

// 关闭连接

conn.disconnect();

\} **catch** (Exceptione) \{

e.printStackTrace();

//将返回的字符串转换成json

JSONObject jsonObject = JSONObject.*fromObject*(bufferRes.toString());

//解析json中表示openid的列表

JSONObject data = (JSONObject)jsonObject.get("data");

**if**(data!=**null**)\{

//将openid列表转化成数组保存

users = **new**ArrayList<String>(data.getJSONArray("openid"));

//获取关注者总数

**int**count = Integer.*parseInt*(jsonObject.get("total").toString());

**if**(count>1000)\{

JSONObjectobject=jsonObject;

Stringnext\_openid=**null**;

JSONObjectob\_data=**null**;

ArrayList<String>ob\_user=**null**;

//大于1000需要多次获取，或许次数为count/1000

**for**(**int**i=0;i<count/1000;i\++)\{

//解析出下次获取的启示openid

next\_openid = object.get("next\_openid").toString();

object = *getUserJson*(next\_openid);

ob\_data = (JSONObject)object.get("data");

ob\_user = **new**ArrayList<String>(ob\_data.getJSONArray("openid"));

**for**(Stringopen\_id : ob\_user)\{

//将多次获取的openid添加到同一个数组

users.add(open\_id);

**return**users;

//连续获取关注列表;

**public static** JSONObjectgetUserJson(String next\_openid) \{

StringBuffer bufferRes =**new** StringBuffer();

**try** \{

URL realUrl = **new** URL("https://api.weixin.qq.com/cgi-bin/user/get?access\_token=" + Get\_Token.*access\_token* +"&next\_openid=" + next\_openid);

HttpURLConnection conn = (HttpURLConnection)realUrl.openConnection();

// 请求方式

conn.setDoOutput(**true**);

conn.setDoInput(**true**);

conn.setRequestMethod("GET");

conn.setUseCaches(**false**);

conn.setInstanceFollowRedirects(**true**);

conn.setRequestProperty("Content-Type","application/json");

conn.connect();

// 获取URLConnection对象对应的输入流

InputStream in =conn.getInputStream();

BufferedReader read =**new** BufferedReader(**new** InputStreamReader(in,"UTF-8"));

String valueString =**null**;

**while** ((valueString=read.readLine())!=**null**)\{

bufferRes.append(valueString);

System.***out***.println(bufferRes);

in.close();

**if** (conn !=**null**)\{

// 关闭连接

conn.disconnect();

\} **catch** (Exceptione) \{

e.printStackTrace();

JSONObject jsonObject = JSONObject.*fromObject*(bufferRes);

**return**jsonObject;

//发送模板;

**publicstaticvoid**send\_Json(Stringparams,StringaccessToken)\{

StringBuffer bufferRes =**new** StringBuffer();

**try** \{

URL realUrl = **new** URL("https://api.weixin.qq.com/cgi-bin/message/template/send?access\_token="\+accessToken);

HttpURLConnection conn = (HttpURLConnection)realUrl.openConnection();

// 请求方式

conn.setDoOutput(**true**);

conn.setDoInput(**true**);

conn.setRequestMethod("POST");

conn.setUseCaches(**false**);

conn.setInstanceFollowRedirects(**true**);

conn.setRequestProperty("Content-Type","application/json");

conn.connect();

// 获取URLConnection对象对应的输出流

OutputStreamWriter out =**new** OutputStreamWriter(conn.getOutputStream(),"UTF-8");

// 发送请求参数

//out.write(URLEncoder.encode(params,"UTF-8"));

//发送json包

out.write(params);

out.flush();

out.close();

InputStream in =conn.getInputStream();

BufferedReader read =**new** BufferedReader(**new** InputStreamReader(in,"UTF-8"));

String valueString =**null**;

**while** ((valueString=read.readLine())!=**null**)\{

bufferRes.append(valueString);

//输出返回的json

System.***out***.println(bufferRes);

in.close();

**if** (conn !=**null**)\{

// 关闭连接

conn.disconnect();

\} **catch** (Exceptione) \{

e.printStackTrace();

注意：

创建json包时要根据模板内容构造。

列如：交易提醒创建的json为：

\{"touser":"",

"template\_id":"",

"url":"",

"topcolor":"",

"data":\{

"first":\{"value":"","color":""\},

"keyword1":\{"value":"","color":""\},

"keyword2":\{"value":"","color":""\},

"keyword3":\{"value":"","color":""\},

"keyword4":\{"value":"","color":""\},

"keyword5":\{"value":"","color":""\},

"remark":\{"value":"","color":""\}\}\}

笔试通知提醒创建的json为：

\{"touser":"",

"template\_id":"",

"url":"",

"topcolor":"",

"data":\{

"first":\{"value":"","color":""\},

"company":\{"value":"","color":""\},

"datetime":\{"value":"","color":""\},

"address":\{"value":"","color":""\},

"contact":\{"value":"","color":""\},

"remark":\{"value":"","color":""\}\}\}

[Link 1]: http://lib.csdn.net/base/wechat
[https_api.weixin.qq.com_cgi-bin_message_template_send_access_token_ACCESS_TOKEN]: https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
[Center]: /images/20220618/1bced33d69704bccb19fe0248fd632fa.png
[Center 1]: /images/20220618/6416d793f65c4a94b35b16924da142d6.png
[Center 2]: /images/20220618/dd3628f0daa748288d138c5064c46b5c.png
[Center 3]: /images/20220618/a9a2df64eaed470d8f2ecaf4e9ebce53.png
[Center 4]: /images/20220618/9016e56c7c684e328af90aa28d1312d8.png
[Center 5]: /images/20220618/237c687cc7f2408bab33088ea5443406.png
[Center 6]: /images/20220618/dccdb32c7d1447bdaa0a3c3ae3e3224f.png
[Center 7]: /images/20220618/2f98a1f9fa77487385d1954ff1c15fa2.png
[Center 8]: /images/20220618/a0f01e41481d4774b2110904e355b3e5.png
[Java]: http://lib.csdn.net/base/javase
[Link 2]: http://lib.csdn.net/base/softwaretest
[http_mp.weixin.qq.com_wiki_index.php_title]: http://mp.weixin.qq.com/wiki/index.php?title=%E8%8E%B7%E5%8F%96%E5%85%B3%E6%B3%A8%E8%80%85%E5%88%97%E8%A1%A8
[.NET]: http://lib.csdn.net/base/dotnet