lxm_library_java/WxJava
1
0
Fork 0
mirror of synced 2026-10-18 05:16:10 +08:00
Code Issues Projects Releases Wiki Activity

🆕 #3931【企业微信】第三方应用增加消息发送相关接口支持

Browse Source
This commit is contained in:
Copilot
2026-06-05 18:26:17 +08:00
committed by GitHub
parent f2f5957777
commit 990eb71703
6 changed files with 300 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

86
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpMessageService.java Normal file
View File

@@ -0,0 +1,86 @@
package me.chanjar.weixin.cp.tp.service;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.cp.bean.message.*;
/**
* 企业微信第三方应用消息推送接口.
*
* <p>第三方应用使用授权企业的 access_token 代表授权企业发送应用消息。</p>
*
* @author <a href="https://github.com/github-copilot">GitHub Copilot</a>
*/
public interface WxCpTpMessageService {
/**
* <pre>
* 发送应用消息（代授权企业发送）.
* 详情请见: https://work.weixin.qq.com/api/doc/90000/90135/90236
* </pre>
*
* @param message 要发送的消息对象
* @param corpId 授权企业的 corpId
* @return 消息发送结果
* @throws WxErrorException 微信错误异常
*/
WxCpMessageSendResult send(WxCpMessage message, String corpId) throws WxErrorException;
/**
* <pre>
* 查询应用消息发送统计.
* 请求方式：POST（HTTPS）
* 请求地址：https://qyapi.weixin.qq.com/cgi-bin/message/get_statistics?access_token=ACCESS_TOKEN
* 详情请见: https://work.weixin.qq.com/api/doc/90000/90135/92369
* </pre>
*
* @param timeType 查询哪天的数据，0：当天；1：昨天。默认为0。
* @param corpId 授权企业的 corpId
* @return 统计结果
* @throws WxErrorException 微信错误异常
*/
WxCpMessageSendStatistics getStatistics(int timeType, String corpId) throws WxErrorException;
/**
* <pre>
* 互联企业发送应用消息.
* 请求地址：https://qyapi.weixin.qq.com/cgi-bin/linkedcorp/message/send?access_token=ACCESS_TOKEN
* 文章地址：https://work.weixin.qq.com/api/doc/90000/90135/90250
* </pre>
*
* @param message 要发送的消息对象
* @param corpId 授权企业的 corpId
* @return 消息发送结果
* @throws WxErrorException 微信错误异常
*/
WxCpLinkedCorpMessageSendResult sendLinkedCorpMessage(WxCpLinkedCorpMessage message, String corpId) throws WxErrorException;
/**
* <pre>
* 发送「学校通知」.
* https://developer.work.weixin.qq.com/document/path/92321
* 学校可以通过此接口来给家长发送不同类型的学校通知。
* 请求方式：POST（HTTPS）
* 请求地址：https://qyapi.weixin.qq.com/cgi-bin/externalcontact/message/send?access_token=ACCESS_TOKEN
* </pre>
*
* @param message 要发送的消息对象
* @param corpId 授权企业的 corpId
* @return 消息发送结果
* @throws WxErrorException 微信错误异常
*/
WxCpSchoolContactMessageSendResult sendSchoolContactMessage(WxCpSchoolContactMessage message, String corpId) throws WxErrorException;
/**
* <pre>
* 撤回应用消息.
* 请求地址: https://qyapi.weixin.qq.com/cgi-bin/message/recall?access_token=ACCESS_TOKEN
* 文档地址: https://developer.work.weixin.qq.com/document/path/94867
* </pre>
*
* @param msgId 消息id
* @param corpId 授权企业的 corpId
* @throws WxErrorException 微信错误异常
*/
void recall(String msgId, String corpId) throws WxErrorException;
}

18
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpService.java
View File

@@ -530,6 +530,24 @@ public interface WxCpTpService {
*/
WxCpTpLicenseService getWxCpTpLicenseService();
/**
* get message service
*
* @return WxCpTpMessageService wx cp tp message service
*/
default WxCpTpMessageService getWxCpTpMessageService() {
throw new UnsupportedOperationException("WxCpTpMessageService is not supported");
}
/**
* set message service
*
* @param wxCpTpMessageService the message service
*/
default void setWxCpTpMessageService(WxCpTpMessageService wxCpTpMessageService) {
throw new UnsupportedOperationException("WxCpTpMessageService is not supported");
}
WxCpTpXmlMessage fromEncryptedXml(String encryptedXml,
String timestamp, String nonce, String msgSignature);

11
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/BaseWxCpTpServiceImpl.java
View File

@@ -61,6 +61,7 @@ public abstract class BaseWxCpTpServiceImpl<H, P> implements WxCpTpService, Requ
private WxCpTpIdConvertService wxCpTpIdConvertService = new WxCpTpIdConvertServiceImpl(this);
private WxCpTpOAuth2Service wxCpTpOAuth2Service = new WxCpTpOAuth2ServiceImpl(this);
private WxCpTpCustomizedService wxCpTpCustomizedService = new WxCpTpCustomizedServiceImpl(this);
private WxCpTpMessageService wxCpTpMessageService = new WxCpTpMessageServiceImpl(this);
/**
* 全局的是否正在刷新access token的锁.
*/
@@ -665,6 +666,16 @@ public abstract class BaseWxCpTpServiceImpl<H, P> implements WxCpTpService, Requ
this.wxCpTpLicenseService = wxCpTpLicenseService;
}
@Override
public WxCpTpMessageService getWxCpTpMessageService() {
return wxCpTpMessageService;
}
@Override
public void setWxCpTpMessageService(WxCpTpMessageService wxCpTpMessageService) {
this.wxCpTpMessageService = wxCpTpMessageService;
}
@Override
public void setWxCpTpUserService(WxCpTpUserService wxCpTpUserService) {
this.wxCpTpUserService = wxCpTpUserService;

66
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java Normal file
View File

@@ -0,0 +1,66 @@
package me.chanjar.weixin.cp.tp.service.impl;
import com.google.common.collect.ImmutableMap;
import com.google.gson.JsonObject;
import lombok.RequiredArgsConstructor;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.cp.bean.message.*;
import me.chanjar.weixin.cp.tp.service.WxCpTpMessageService;
import me.chanjar.weixin.cp.tp.service.WxCpTpService;
import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder;
import static me.chanjar.weixin.cp.constant.WxCpApiPathConsts.Message.*;
/**
* 企业微信第三方应用消息推送接口实现类.
*
* <p>代授权企业发送应用消息，所有方法均需传入授权企业的 corpId。</p>
*
* @author <a href="https://github.com/github-copilot">GitHub Copilot</a>
*/
@RequiredArgsConstructor
public class WxCpTpMessageServiceImpl implements WxCpTpMessageService {
private final WxCpTpService mainService;
@Override
public WxCpMessageSendResult send(WxCpMessage message, String corpId) throws WxErrorException {
String url = mainService.getWxCpTpConfigStorage().getApiUrl(MESSAGE_SEND)
+ "?access_token=" + mainService.getWxCpTpConfigStorage().getAccessToken(corpId);
return WxCpMessageSendResult.fromJson(this.mainService.post(url, message.toJson(), true));
}
@Override
public WxCpMessageSendStatistics getStatistics(int timeType, String corpId) throws WxErrorException {
String url = mainService.getWxCpTpConfigStorage().getApiUrl(GET_STATISTICS)
+ "?access_token=" + mainService.getWxCpTpConfigStorage().getAccessToken(corpId);
return WxCpMessageSendStatistics.fromJson(
this.mainService.post(url, WxCpGsonBuilder.create().toJson(ImmutableMap.of("time_type", timeType)), true));
}
@Override
public WxCpLinkedCorpMessageSendResult sendLinkedCorpMessage(WxCpLinkedCorpMessage message, String corpId)
throws WxErrorException {
String url = mainService.getWxCpTpConfigStorage().getApiUrl(LINKEDCORP_MESSAGE_SEND)
+ "?access_token=" + mainService.getWxCpTpConfigStorage().getAccessToken(corpId);
return WxCpLinkedCorpMessageSendResult.fromJson(this.mainService.post(url, message.toJson(), true));
}
@Override
public WxCpSchoolContactMessageSendResult sendSchoolContactMessage(WxCpSchoolContactMessage message, String corpId)
throws WxErrorException {
String url = mainService.getWxCpTpConfigStorage().getApiUrl(EXTERNAL_CONTACT_MESSAGE_SEND)
+ "?access_token=" + mainService.getWxCpTpConfigStorage().getAccessToken(corpId);
return WxCpSchoolContactMessageSendResult.fromJson(this.mainService.post(url, message.toJson(), true));
}
@Override
public void recall(String msgId, String corpId) throws WxErrorException {
JsonObject jsonObject = new JsonObject();
jsonObject.addProperty("msgid", msgId);
String url = mainService.getWxCpTpConfigStorage().getApiUrl(MESSAGE_RECALL)
+ "?access_token=" + mainService.getWxCpTpConfigStorage().getAccessToken(corpId);
this.mainService.post(url, jsonObject.toString(), true);
}
}