一、登录微信公众号后台,开通模板消息功能,选择使用的模板消息或者申请新的模板消息,只有通过企业认证才能使用模板消息
模板消息申请下来后,保存模板消息Id,后续发送模板消息使用
二、接口权限 => 网页服务 => 网页授权 => 申请/修改
三、配置域名,三项都要配置。注意前面不要加http或https,后面不可带端口号。还需要下载一个校验文件,把下载下来的校验文件放到所配置域名解析的服务器上,需要域名+检验文件名可以访问到这个文件才算校验通过,后面不能有端口(例如:wx.qq.com/MP_verify_FF1peUkHP0MrdJqN.txt;)。
ps:放校验文件的时候需要注意,http默认端口是80,https默认端口是443
四、配置IP白名单。作用:后续获取access_token访问接口时,需要设置访问来源IP为白名单,如不配置就拿不到token,每台机器上请求返回的ip都会不一样,把开发机器和服务器拿到的ip都配置一样就好,配置多个ip时每个ip用回车隔开就行。怎么获取来源ip:如果没有配置ip白名单,请求获取access_token时会返回一个ip,把这个ip配上去就行了。另外顺便保存一下appId和AppSecret,方便后续使用。
五、以上为发送模板消息的准备工作,下面是重点
一、获取code:需要更换的参数是appid、redirect_uri,其他参数不变,其中scope有两个参数,以snsapi_base为 scope 发起的网页授权,是用来获取进入页面的用户的 openid 的,并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页(往往是业务页面);
以snsapi_userinfo为 scope 发起的网页授权,是用来获取用户的基本信息的。但这种授权需要用户手动同意,并且由于用户同意过,所以无须关注,就可在授权后获取该用户的基本信息。我这里用的是静默授权然后跳转到相关页面。另外还要注意的是这个地址只能在微信客户端请求才有用,可以用微信开发者工具切换成公众号调试模式测试,请求后会自动重定向,在跳转的地址后面拼上一个code,这个就是我们需要的参数。
https://open.weixin.qq.com/connect/oauth2/authorize?appid=你的appid&redirect_uri=要跳转的地址/页面&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
二、通过code换取网页授权access_token,拿到openId
注意上面拿到的code只能使用一次,并且有效时长为5分钟,失效必须重新获取
https://api.weixin.qq.com/sns/oauth2/access_token?appid=你的appid&secret=你的secret&code=上面地址栏拿到的code&grant_type=authorization_code
三、获取token(此token与上面的access_token不一样),此token用于发送模板消息用以及其他api接口的调用
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=你的appid&secret=你的secret
四、发送模板消息
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=上面获取到的token
POST数据示例如下:
{ "touser":"OPENID", "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY", "url":"http://weixin.qq.com/download", "miniprogram":{ "appid":"xiaochengxuappid12345", "pagepath":"index?foo=bar" }, "client_msg_id":"MSG_000001", "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" } } }
1.获取用户openid,参数为code
@GetMapping("/getOpenId") @ApiOperation(value = "微信公众号获取用户openid") public String getOpenId(@RequestParam String code){ String url= "https://api.weixin.qq.com/sns/oauth2/access_token" + "?appid=" + appId + "&secret=" + appSecret + "&code="+ code+"&grant_type=authorization_code"; RestTemplate restTemplate=new RestTemplate(); String response=restTemplate.getForObject(url,String.class); JSONObject jsonObj = new JSONObject(response); String openid = jsonObj.get("openid").toString(); return openid; }
2.获取token
public String getWeiXinToken(){ String url="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="+ appId + "&secret=" + appSecret; RestTemplate restTemplate = new RestTemplate(); String forObject = restTemplate.getForObject(url, String.class); JSONObject jsonObj = new JSONObject(forObject); return jsonObj.get("access_token").toString(); }
3.准备一个模板消息实体类
@Datapublic class WxTemplateMsg { private String touser; private String template_id; private String url; // "miniprogram":{ 未加入 // "appid":"xiaochengxuappid12345", // "pagepath":"index?foo=bar" // }, private TreeMap> data; public static TreeMap item(String value, String color) { TreeMap params = new TreeMap(); params.put("value", value); params.put("color", color); return params; }}
4.模板消息封装,消息参数根据自己选择的模板消息来
public String noticeTemplate(String openIdd,String siteName,String airIndex,String value1,String value2,String airIndexTime) { // 模版ID String templateId="你的模板消息id"; TreeMap> params = new TreeMap<>(); //根据具体模板参数组装 params.put("first", WxTemplateMsg.item(siteName, "#000000")); params.put("keyword1", WxTemplateMsg.item(airIndex, "#000000")); params.put("keyword2", WxTemplateMsg.item(value1, "#000000")); params.put("keyword3", WxTemplateMsg.item(value2, "#000000")); params.put("remark", WxTemplateMsg.item(airIndexTime, "#000000")); WxTemplateMsg wxTemplateMsg = new WxTemplateMsg(); // 模版ID wxTemplateMsg.setTemplate_id(templateId); // 消息接收者openId wxTemplateMsg.setTouser(openIdd); // 关键字赋值 wxTemplateMsg.setData(params); String data = JSONUtil.toJsonStr(wxTemplateMsg); return data; }
5.发送模板消息
public void sendTemplateMsg(String openId,String siteName,String airIndex,String value1,String value2,String airIndexTime){ //获取token String weiXinToken = getWeiXinToken(); String data = noticeTemplate(openId,siteName,airIndex,value1,value2,airIndexTime); //发送消息 okhttp3.RequestBody requestBody = okhttp3.RequestBody.create(MediaType.parse("application/json"), data); Request request = new Request.Builder().url("https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=" + weiXinToken).post(requestBody).build(); OkHttpClient okHttpClient = new OkHttpClient(); Response execute = null; try { execute = okHttpClient.newCall(request).execute(); String body = execute.body().string(); if(execute.code() == 200){ System.out.println("模板消息发送成功==========" + body); }else{ System.out.println("模板消息发送失败==========" + body); } } catch (IOException e) { e.printStackTrace(); } }
OK,至此模板消息发送流程就完啦!