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

 更新时间:2025年06月24日 11:27:50   作者:WuWuII  
这篇文章主要介绍了java向微信服务号发送消息的相关资料,包括申请测试号获取appID/appsecret、关注公众号获取openID、配置消息模板及代码实现,需要的朋友可以参考下

https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html

步骤

  1. 申请测试系统
  2. 拿到公众号appIDappsecret
  3. 关注测试公众号
  4. 创建消息模板
  5. 编辑java代码进行测试

1. 申请测试系统

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

2. 公众号账号信息

申请成功后,会跳转到测试系统页面,这里有appIDappsecret

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","上海"));
      贴张图

到此这篇关于java向微信服务号发送消息的文章就介绍到这了,更多相关java微信服务号发送消息内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java实现在不同线程中运行的代码实例

    Java实现在不同线程中运行的代码实例

    这篇文章主要介绍了Java实现在不同线程中运行的代码,结合具体实例形式分析了java多线程操作的相关实现技巧,需要的朋友可以参考下
    2017-04-04
  • Java实现的进制转换工具类完整示例

    Java实现的进制转换工具类完整示例

    这篇文章主要介绍了Java实现的进制转换工具类,结合完整实例形式分析了Java实现二进制、十六进制、字符串、数组等相关转换操作技巧,需要的朋友可以参考下
    2018-07-07
  • CAT分布式实时监控系统使用详解

    CAT分布式实时监控系统使用详解

    这篇文章主要为大家介绍了CAT分布式实时监控系统介绍详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03
  • Java bat批处理命令启动jar包的操作方法

    Java bat批处理命令启动jar包的操作方法

    这篇文章主要介绍了JAVA bat批处理命令启动jar包,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2024-12-12
  • Java使用Spring Batch处理大规模数据的实践分享

    Java使用Spring Batch处理大规模数据的实践分享

    在处理大规模数据的场景中,批处理是一个非常常见且必要的操作,Java中的Spring Batch是一个强大的框架,能够帮助我们高效地执行复杂的批处理任务,本文将带大家了解如何使用Spring Batch处理大规模数据,并通过代码示例展示如何实现高效的批处理,需要的朋友可以参考下
    2024-10-10
  • SpringBoot中jar启动下如何读取文件路径

    SpringBoot中jar启动下如何读取文件路径

    这篇文章主要介绍了SpringBoot jar启动下如何读取文件路径,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • Java 项目连接并使用 SFTP 服务的示例详解

    Java 项目连接并使用 SFTP 服务的示例详解

    SFTP是一种安全的文件传输协议,是SSH(Secure Shell)协议的一个子协议,设计用于加密和保护文件传输的安全性,这篇文章主要介绍了Java 项目如何连接并使用 SFTP 服务的示例详解,需要的朋友可以参考下
    2025-01-01
  • SSM+微信小程序实现物业管理系统及实例代码

    SSM+微信小程序实现物业管理系统及实例代码

    这篇文章主要介绍了SSM+微信小程序实现物业管理系统,ssm微信小程序物业管理系统,有网站后台管理系统,本文通过实例代码给大家展示系统的功能,需要的朋友可以参考下
    2022-02-02
  • java数据库开发之JDBC基础使用方法及实例详解

    java数据库开发之JDBC基础使用方法及实例详解

    这篇文章主要介绍了java数据库开发之JDBC基础知识详解,需要的朋友可以参考下
    2020-02-02
  • 排序算法的Java实现全攻略

    排序算法的Java实现全攻略

    这篇文章主要介绍了排序算法的Java实现,包括Collections.sort()的使用以及各种经典算法的Java代码实现方法总结,超级推荐!需要的朋友可以参考下
    2015-08-08

最新评论