java向微信服务号发送消息的完整步骤实例_Java

https://developers.weixin.qq.com/doc/offiaccount/getting_started/overview.html

步骤

申请测试系统
拿到公众号appid和appsecret
关注测试公众号
创建消息模板
编辑java代码进行测试

1. 申请测试系统

申请测试系统，相当于给你申请了一个测试用的公众号，用来测试发送消息，地址：申请测试

2. 公众号账号信息

申请成功后，会跳转到测试系统页面，这里有appid和appsecret，

3. 关注测试号二维码

找到测试二维码，扫描二维码，相当于关注你申请的测试公众号，扫描关注后，右边是关注了这个测试公众号的用户，微信号就是openid,java代码发送消息的时候，就是指定这个openid（微信号）

4. 消息模板接口

找到模板消息接口，点击新增测试模板，编辑内容，如果是要填充数据，要以{{字段名.data}}的格式保存，data是固定的

5. java测试

import cn.hutool.http.httputil;
import com.alibaba.fastjson2.json;
import com.alibaba.fastjson2.jsonobject;
import org.springframework.stereotype.service;

import java.time.localdatetime;
import java.util.hashmap;
import java.util.map;

@service
public class messagesendservice {

    private static final string send_msg_api = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=";
	//值是步骤3中，关注的用户的微信号
    private string openid="";
	//固定值
    private string grant_type="client_credential";
	//公众号的appid，我这里使用的测试系统的，在步骤2中
    private string appid="";
	//公众号的secret，我这里使用的测试系统的，在步骤2中
    private string secret="";
    /***
     * 发送模板消息
     *  （消费成功通知）
     */
    public map<string, object> sendcreateordertemplatemsg() {
        //获取token，获取的是公众号的token，验证通过，拿到token才能发送给关注了自己公众号的微信用户
        string token = this.gettoken();
        //消息模板id，步骤3中的模板的id
        string template_id = "cxlpooon67-fcjvabt9mhbljfwpklkwhm6ae0rh3jjo";
        // 接口地址
        string sendmsgapi = send_msg_api + token;
        //openid微信号关注服务号的唯一标识
        string touser = openid;
        //整体参数map
        map<string, object> parammap = new hashmap<>();
        //消息主题显示相关map
        map<string, object> datamap = new hashmap<string, object>();
        //对应消息模板的{{datetime.data}},第二个参数是颜色，目前测试是无效的，可以不要
        datamap.put("datetime",  createmsg(string.valueof(localdatetime.now()),"#8c2444"));
        datamap.put("address", createmsg("上海", "#8c2444"));
		//touser就是接收人的openid,步骤3中的微信号
        parammap.put("touser", touser);
        //template_id是步骤4中创建的模板的id
        parammap.put("template_id", template_id);
        //data是模板中的参数的map集合，键值对
        parammap.put("data", datamap);

        return map.of("result",httputil.post(sendmsgapi, json.tojsonstring(parammap)));
    }

    /**
     * 构建消息，
     * @param value
     * @param color
     * @return
     */
    private map<string, object> createmsg(string value,string color) {
        return map.of("value",value,"color",color);
    }


    /**
     * 获取token
     * @return token
     */
    public string gettoken() {

        // 接口地址拼接参数(appid为微信服务号的appid，secret为服务号的秘钥)
        string gettokenapi = "https://api.weixin.qq.com/cgi-bin/token?grant_type=" + grant_type + "&appid=" + appid
                + "&secret=" + secret;
        string tokenjsonstr = httputil.get(gettokenapi);
        jsonobject tokenjson = jsonobject.parseobject(tokenjsonstr);
        string token = tokenjson.get("access_token").tostring();
        system.out.println("获取到的token : " + token);
        return token;
    }
}

成功接收

其它

需要主意的是，这里使用的是申请的测试的公众号，有了实际的公众号，可能要主意是否添加了指定服务器的白名单，否则会报错40164：{"errcode":40164,"errmsg":"invalid ip ipv6 ::ffff:, not in whitelist rid: 68461f004be2"}
模板配置的参数格式是{{datetime.data}}，这里{{.data}}都是固定的，datetime是参数名，它的值是一个map,key是value，这个key是固定的，而实际的value才是真正的datetime值，可能有点绕。看下面实际效果，应该就明白了。
- 这里有个值，color，是可选的，可以设置值的颜色，但是测试中没有生效，不知道真实的会不会生效，不传也可以，直接datamap.put("address", map.of("value","上海"));
  贴张图