Java 对接企业微信（文本消息推送）

已于 2023-12-18 11:05:23 修改
阅读量1.8k 收藏 18
点赞数 11
分类专栏： Spring Boot 文章标签： java 企业微信
于 2023-12-08 14:49:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/m0_50542823/article/details/134877376
版权

Java 对接企业微信（文本消息推送）

背景

公司的项目，通知信息打算接入企业微信通知。提前做下实验。

版本

JDK 21
SpringBoot 3.1.5
weixin-java-cp 4.5.0
hutool-all 5.8.23
jedis 5.1.0

说明：暂时只是一个springboot小demo，后续根据项目会有组件和结构的修改。

代码

代码比较简单，配置好参数直接调用即可。
这里全部贴到这里，后面会讲解每一步所需要的参数来源及怎么配置。

POM

    <properties>
        <java.version>21</java.version>
        <snakeyaml.version>2.2</snakeyaml.version>
        <jakarta.validation-api.version>3.0.2</jakarta.validation-api.version>
        <hibernate-validator.version>8.0.1.Final</hibernate-validator.version>
        <fastjson.version>2.0.43</fastjson.version>
        <weixin-java-cp.version>4.5.0</weixin-java-cp.version>
        <hutool-all.version>5.8.23</hutool-all.version>
        <jedis.version>5.1.0</jedis.version>
    </properties>
<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
        <!-- https://mvnrepository.com/artifact/cn.hutool/hutool-all -->
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>${hutool-all.version}</version>
        </dependency>
        <!-- 可不引入 https://mvnrepository.com/artifact/redis.clients/jedis -->
        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>${jedis.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.github.binarywang/weixin-java-cp -->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-cp</artifactId>
            <version>${weixin-java-cp.version}</version>
        </dependency>

        <dependency>
            <groupId>jakarta.validation</groupId>
            <artifactId>jakarta.validation-api</artifactId>
            <version>${jakarta.validation-api.version}</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator -->
        <dependency>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>${hibernate-validator.version}</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>${fastjson.version}</version>
        </dependency>
    </dependencies>

配置实体

@Data
@Component
@ConfigurationProperties(value = "wechat2")
public class WechatConfig {
    /**
     * 要发送消息的应用的两个字段
     */
    @Value("${wechat2.agentid}")
    private Integer agentId;
    /**
     *
     */
    @Value("${wechat2.secret}")
    private String secret;
    /**
     * 企业id
     */
    @Value("${wechat2.corpid}")
    private String corpId;
    /**
     * 用于访问redis的密码，没设置就不需要这个字段
     */
    @Value("${wechat2.redis-pwd}")
    private String redisPwd;
}

工具类

redis 工具类

@Slf4j
@Configuration
public class RedisUtils {
    @Autowired
    private StringRedisTemplate stringRedisTemplate;



    /**
     * 设定 key对应的值为一个数值，每次调用 - value
     *
     * @param key   key
     * @param value value
     * @return 减 value 之后的值
     */
    public long decrementBy(String key, long value) {
        log.info("decrement key:{}", key);
        Long len = stringRedisTemplate.opsForValue().decrement(key, value);
        if (Objects.isNull(len)) {
            return 0;
        }
        return (long) len;
    }

    /**
     * 设定 key对应的值为一个数值，每次调用 -1
     *
     * @param key key
     * @return 减 1 之后的值
     */
    public long decrement(String key) {
        log.info("DECR key:{}", key);
        Long len = stringRedisTemplate.opsForValue().decrement(key);
        if (Objects.isNull(len)) {
            return 0;
        }
        return (long) len;
    }

    /**
     * 追加值 返回追加之后的字符长度
     *
     * @param key   key
     * @param value value
     * @return 字符长度
     */
    public int append(String key, String value) {
        log.info("APPEND key:{}, value:{}", key, value);
        Integer add = stringRedisTemplate.opsForValue().append(key, value);
        if (Objects.isNull(add)) {
            return 0;
        }
        return (int) add;
    }

    /**
     * 设值
     *
     * @param key   key
     * @param value value
     */
    public void set(String key, String value) {
        log.info("SET key:{}, value:{}", key, value);
        stringRedisTemplate.opsForValue().set(key, value);
    }

    /**
     * 设值
     *
     * @param key        key
     * @param value      value
     * @param expireTime 过期时间 单位 s
     */
    public void set(String key, String value, int expireTime) {
        log.info("SETEX key:{}, value:{}, expireTime:{}", key, value, expireTime);
        stringRedisTemplate.opsForValue().set(key, value, expireTime, TimeUnit.SECONDS);
    }


    /**
     * 取值
     *
     * @param key key
     * @return 值
     */

    public String get(String key) {
        String value = stringRedisTemplate.opsForValue().get(key);
        log.info("GET key:{}, value:{}", key, value);
        return value;
    }

    /**
     * 删除 key
     *
     * @param key key
     * @return 是否删除
     */
    public Boolean del(String key) {
        if (exists(key)) {
            return stringRedisTemplate.delete(key);
        }
        log.error("del key:{} 不存在", key);
        return false;
    }

    /**
     * 判断key是否存在，如果存在则删除，不存在返回 空
     *
     * @param key -
     * @return -
     */
    public Boolean getAndDelete(String key) {
        String ret = stringRedisTemplate.opsForValue().getAndDelete(key);
        log.info("GETDEL key:{}, result:{}", key, ret);
        return StringUtils.isNotBlank(ret);
    }


    /**
     * 判断 key 是否存在
     *
     * @param key key
     * @return 是否存在
     */
    public Boolean exists(String key) {
        Boolean exists = stringRedisTemplate.hasKey(key);
        log.info("exists key:{}, hasKey:{}", key, exists);
        return exists;
    }
}

@Slf4j
@Component
public class WechatConfigUtil {
    @Resource
    private WechatConfig wechatConfig;

	@Autowired
    private RedisUtils redisUtils;

    /**
     * 配置企业微信服务
     *
     * @return -
     */
    public WxCpService wxCpService() {
        WxCpService wxCpService = new WxCpServiceImpl();
        WxCpDefaultConfigImpl config = new WxCpDefaultConfigImpl();
        config.setAgentId(wechatConfig.getAgentId());
        config.setCorpSecret(wechatConfig.getSecret());
        config.setCorpId(wechatConfig.getCorpId());
        resetTokenAndJsApi2(wxCpService, config);
        return wxCpService;
    }
    
    public void resetTokenAndJsApi2(WxCpService wxCpService, WxCpDefaultConfigImpl wxCpDefaultConfig) {
        try {
            wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
            String accessToken;
            // 获取TOKEN
            accessToken = wxCpService.getAccessToken(false);
            log.info("accessToken:{}", accessToken);
            wxCpDefaultConfig.setAccessToken(accessToken);
        } catch (Exception e) {
            log.error(e.getMessage());
        }

    }

    /**
     * 重置token
     *
     * @param wxCpService       -
     * @param wxCpDefaultConfig -
     */
    public void resetTokenAndJsApi3(WxCpService wxCpService, WxCpDefaultConfigImpl wxCpDefaultConfig) {
        wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
        String wxAccessToken = "wx" + wechatConfig.getAgentId();
        // 根据应用id获取对应token
        String json = redisUtils.get(wxAccessToken);
        // redis里无token
        if (StringUtils.isBlank(json)) {
            String accessToken;
            // 获取TOKEN
            try {
                accessToken = wxCpService.getAccessToken(false);
            } catch (WxErrorException e) {
                throw new RuntimeException(e);
            }
            log.info("null, new accessToken:{}", accessToken);
            wxCpDefaultConfig.setAccessToken(accessToken);
            wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
            // 缓存token
            redisUtils.set(wxAccessToken, JSON.toJSONString(wxCpDefaultConfig));
            return;
        }
        // redis 里有token
        wxCpDefaultConfig = JSON.parseObject(json, WxCpDefaultConfigImpl.class);
        log.info("redis entity:{}", JSON.toJSONString(wxCpDefaultConfig));
        // token 到期
        if (wxCpDefaultConfig.isAccessTokenExpired()) {
            try {
                String accessToken;
                // 获取 新TOKEN
                accessToken = wxCpService.getAccessToken(false);
                log.info("expired, new accessToken:{}", accessToken);
                wxCpDefaultConfig.setAccessToken(accessToken);
                wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
                // 缓存token
                redisUtils.set(wxAccessToken, JSON.toJSONString(wxCpDefaultConfig));
            } catch (WxErrorException e) {
                log.error(e.getMessage());
            }
            return;
        }
        log.info("used accessToken:{}", wxCpDefaultConfig.getAccessToken());
        wxCpDefaultConfig.setAccessToken(wxCpDefaultConfig.getAccessToken());
        wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
    }

    /**
     * 重置token 赋值有问题 删了！！！
     *
     * @param wxCpService       -
     * @param wxCpDefaultConfig -
     */
    public void resetTokenAndJsApi(WxCpService wxCpService, WxCpDefaultConfigImpl wxCpDefaultConfig) {
        JedisPool jedisPool = new JedisPool();
        Jedis jedis = jedisPool.getResource();
        if (StringUtils.isNotBlank(wechatConfig.getRedisPwd())) {
            jedis.auth(wechatConfig.getRedisPwd());
        }
        wxCpService.setWxCpConfigStorage(wxCpDefaultConfig);
        String wxAccessToken = "wx" + wechatConfig.getAgentId();
        // 根据应用id获取对应token
        String json = jedis.get(wxAccessToken);
        if (!StringUtils.isEmpty(json)) {
            wxCpDefaultConfig = JSON.parseObject(json, WxCpDefaultConfigImpl.class);
        }
        // token到期
        if (wxCpDefaultConfig.isAccessTokenExpired()) {
            try {
                String accessToken;
                accessToken = wxCpService.getAccessToken(false);
                wxCpDefaultConfig.setAccessToken(accessToken);
            } catch (WxErrorException e) {
                log.error(e.getMessage());
            }
        }
        // 缓存token
        jedis.set(wxAccessToken, JSON.toJSONString(wxCpDefaultConfig));
        jedis.close();
    }
}

发送消息

@Slf4j
@AllArgsConstructor
@NoArgsConstructor
@Component
public class SendWxCpMsg {
    @Autowired
    private WechatConfigUtil wechatConfigUtil;

    public void sendToWxCp(String username) {
        // 微信消息对象
        WxCpMessageServiceImpl wxCpMessageService = new WxCpMessageServiceImpl(wechatConfigUtil.wxCpService());
        WxCpMessage wxCpMessage = new WxCpMessage();
        wxCpMessage.setSafe("0");
        // 设置消息形式，这里设置为卡片消息
        wxCpMessage.setMsgType("textcard");

        var time = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss"));
        // 设置发送用户
        wxCpMessage.setToUser(username);
        // 发送的标题
        wxCpMessage.setTitle("通知标题-TEST");
        // 发送内容
        wxCpMessage.setDescription("祝新年快乐，幸福安康！"
                + "\n" + "当前时间："
                + time + "\n"
                + "点击下方领取祝福");
        // 设置跳转url
        wxCpMessage.setUrl("https://developer.work.weixin.qq.com/community/question");
        wxCpMessage.setBtnTxt("前往");
        try {
            // 发送消息
            WxCpMessageSendResult send = wxCpMessageService.send(wxCpMessage);
            log.info("send result:{}", send);
        } catch (WxErrorException e) {
            log.error("发送信息接口调用出错: {}", e.getMessage());
        }
    }
}

测试

@RestController
public class MsgSendController {
    @Resource
    private SendWxCpMsg sendWxCpMsg;

    @GetMapping("/send")
    private void send() {
        sendWxCpMsg.sendToWxCp("Xxxxxx.Xxx");
    }
}

配置文件

wechat2:
  corpid: xxxxxxx1
  agentid: 1000002
  secret: xxxxxxx2
  redis-pwd:
spring:
  data:
    redis:
      ssl:
        enabled: false
      host: 127.0.0.1
      port: 6379
      database: 0
      # 超时时间
      timeout: 1000
      password:
      lettuce:
        pool:
          # 连接池最大的连接数
          max-active: 64
          # 连接尝试分配阻塞时间
          max-wait: 3s
          # 连接池最小空闲连接数
          min-idle: 0
          # 连接池最大的空闲数
          max-idle: 32
          # 空闲连接线程释放周期时间
          time-between-eviction-runs: 1s

配置文件中的参数来源

secret

在这里插入图片描述

corpid

在这里插入图片描述

agentid

在这里插入图片描述

执行

到这里，基本的配置已经OK，可以跑下代码。

异常

会报如下异常：
在这里插入图片描述

【错误信息】：错误代码：60020, 错误信息：访问ip不在白名单之中；请确认访问ip是否在服务商白名单IP列表，微信原始报文：{"errcode":60020,"errmsg":"not allow to access from your ip, hint: [170201673442683], from ip: xxx.7xx.xxx.10, more info at https://open.work.weixin.qq.com/devtool/query?e=60020"}

原因

没有配置可信域名
在这里插入图片描述

这里如何配置？
见官网：设置可信域名时，提示“检查域名所有权不通过”

注意：它这里必须要有域名可以公网访问，必须要企业微信能调通，不然不会通过的。

OK，也就是到这里，就终止了实验。
后面公司申请流程通过之后，拿到公司域名再来实验，bye。

文档

  • 个人申请企业微信，进入工作台地址：企业微信工作台
  • 有不清楚的术语可以参考企业微信开发者中心：企业微信开发者中心
  • 可参考 https://blog.youkuaiyun.com/weixin_50495215/article/details/132903103?spm=1001.2101.3001.6650.2&utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7EYuanLiJiHua%7EPosition-2-132903103-blog-122540462.235%5Ev39%5Epc_relevant_3m_sort_dl_base4&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7EYuanLiJiHua%7EPosition-2-132903103-blog-122540462.235%5Ev39%5Epc_relevant_3m_sort_dl_base4&utm_relevant_index=5
Java企业微信对接
岁月不饶人，我亦未曾饶过岁月
12-01 2085
最近项目中要对接企业微信，实现通讯录数据同步，即在企业端添加编辑删除用户，部门数据要同步到微信端，同时微信端添加编辑删除用户，部门数据要同步到企业端，实现数据同步功能，需要调用企业微信API和通讯录回调接口，下面就把对接过程中遇到的各种问题，各种坑记录下来分享给需要的同学
JAVA对接企业微信，实现文本消息推送
M17854278376的博客
01-17 2726
java后台对接企业微信实现消息推送，java实现推送文本消息到企业微信
企业自建应用对接企业微信发送消息接口
Fristm的博客
10-01 4561
如果上面参数都对的话我们就可以调试接口就可以测试了下面我们上代码主要分为两个方法一个是获取token 一个是拿到token以后我门发送消息的方法大概就这两个方法。3,我们拿到token以后我们带这这个token 发消息下面有几个必须添加的参数其它的看你们需求。2.我们可以先简单看一下在他们的调试工具走通了大概代码也会写了我下面一步一步带这大家来。下面我圈起来的就是必须的参数,我选着的是用户id发送消息,他可以多也可以一个使用|隔开。大概就是这些了如果有什么写的不对的或者大家有什么不懂的都可以问我。
Java对接企业微信实战笔记
最新发布
hcyxsh的博客
04-25 639
② 根据已有的token，结合第1步获取的参数timestamp, nonce, echostr重新计算签名，然后与参数msg_signature检查是否一致，③ 确认调用者的合法性。消息体中包括SuitedId，其中InfoType的类型是suite_ticket，那么拿到SuiteTicket的值就是suite_ticket的值了，可以将该值存到库里，也可实时获取。B.构建安装应用链接：【https://developer.work.weixin.qq.com/document/path/90597】
java对接企业微信
zhang2312600_a的博客
10-26 8296
java对接企业微信
Java 推送企业微信消息
weixin_50495215的博客
09-15 7032
企业微信支持接口推送消息，包括文本、图片、视频等信息，对于业务来说，提示告警信息、推送会议信息可以使用。
Java集成企业微信的消息推送
ywang0224的博客
07-03 1787
企业微信开放了消息发送接口，企业可以使用这些接口让自定义应用与企业微信后台或用户间进行双向通信。
Java 实现企业微信消息推送
lang09的博客
04-09 2009
1 新建应用 登陆微信管理(如果没有请先注册) https://work.weixin.qq.com/wework_admin/loginpage_wx?etype=otherLogin#apps/modApiApp/5629501376549416 第二步，点击应用管理--> 创建应用。 第三步，上传logo，输入应用名称，点击创建应用按钮。 2 找到corpid和secret 第一步，打开我的企业->企业信息->企业ID。企业ID就是corpid。 第二步，打开应用管理-&
java实现企业微信消息推送
03-10
在企业微信API开发中，Java作为一种广泛使用的编程语言，提供了丰富的库和工具来实现与企业微信接口的交互，实现消息推送功能。以下是一份详细的Java实现企业微信消息推送的知识点详解： 1. **企业微信API概述** ...
基于Java实现企业微信群聊机器人-文件上传+消息推送（保证可用）
weixin_37689136的博客
03-31 3108
在开发过程中，经常会发生一些运行时异常，需要及时通知运维和开发同学，修复bug并更新系统，避免造成更大的异常和损失，本文主要讲述基于Java如何通过机器人发送消息和上传文档到企业微信群聊。
基于 Feign 实现的企业微信 JAVA SDK, 覆盖 企业微信 所有API，spring-boot-start.zip
03-23
1. **消息推送**：发送文本、图片、文件等多种类型的消息给企业微信用户或部门。 2. **用户管理**：获取用户信息，管理用户的标签，以及进行用户批量操作。 3. **部门管理**：创建、修改和删除企业微信的部门结构。 ...
java调用企业微信接口发送消息所需依赖.zip
05-09
java调用企业微信接口发送消息所需依赖 文章链接：https://blog.youkuaiyun.com/zxl782340680/article/details/79876502
【JAVA】java 企业微信信息推送
JAVA领域优质创作者，基于分片网络查询方法专利发明者。
11-05 954
param.put("content","时间："+new Date().getDateTimeStr()+"\n"+msg);logger.info("微信机器人消息："+url+"---"+msg);logger.error("异常："+url+"---"+msg,e);JAVA中 将信息 推送到企业微信。
java调用企业微信接口API发送消息(替代短信验证码的一种解决方案)
热门推荐
zxl782340680的博客
04-10 3万+
使用企业微信发送验证码文章采纳源地址：https://www.cnblogs.com/kuzaman/p/6564632.html使用微信发送验证码配置页面：以下步骤获取页面上的参数1、注册企业微信：注册网址：https://work.weixin.qq.com/...
java如何对接企业微信
zybb166的博客
01-11 3014
前言 最近实现社群对接企业微信，对接的过程遇到一些点，在此记录。 企业微信介绍 企业微信具有和微信一样的体验，用于企业内部成员和外部客户的管理，可以由此构建出社群生态。 企业微信提供了丰富的api进行调用获取数据管理，也提供了各种回调事件，当数据发生变化时，可以及时知道。 我们分为两部分进行讲解，第一部分调用企业微信api，第二部分，接收企业微信的回调。 调用企业微信api api的开发文档地址： https://work.weixin.qq.com/api/doc/90000/90.
JAVA程序推送消息到企业微信
人的一生就是在学习的道路上不断进步
03-28 2704
程序推送消息到接企业微信用户：将程序的信息推送到企业微信用户，可批量
企业微信推送消息的Java实现教程
weixin_38650077的博客
08-12 1845
在这篇教程中，我们将介绍如何使用Java实现企业微信的消息推送功能，特别是在完成任务后，将结果信息通过企业微信推送给指定的用户。我们将基于您提供的代码进行说明。
Java对接企业微信发送应用消息
kaoninian的博客
06-06 2658
Java对接企业微信发送应用消息和回调配置
Java代码实现向企业微信发送消息
LB_bei的博客
02-27 4095
这个方法需要你服务器的ip是公网ip，然后需要在企业微信添加信任ipt=N7T8企业微信https://work.weixin.qq.com/wework_admin/register_wx?
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值