feat(cp-tp)：为企业微信第三方应用SDK添加消息发送服务（WxCpTpMessageService） by Copilot · Pull Request #3931 · binarywang/WxJava

Copilot · 2026-03-17T02:28:14Z

企业微信第三方应用 SDK（tp 模块）缺少消息发送相关的 Service。与普通 api 包中已有 WxCpMessageService 不同，第三方应用代授权企业发送消息需要使用授权企业的 access_token，因此需要独立封装。

变更内容

新增 WxCpTpMessageService 接口（tp/service/）—— 对应 WxCpMessageService，所有方法增加 corpId 参数：
- send(WxCpMessage, String corpId) — 发送应用消息
- getStatistics(int timeType, String corpId) — 查询消息发送统计
- sendLinkedCorpMessage(WxCpLinkedCorpMessage, String corpId) — 互联企业发送消息
- sendSchoolContactMessage(WxCpSchoolContactMessage, String corpId) — 发送学校通知
- recall(String msgId, String corpId) — 撤回应用消息
新增 WxCpTpMessageServiceImpl 实现类 —— 通过 getAccessToken(corpId) 获取授权企业的 access_token，并以 withoutSuiteAccessToken=true 发起请求，防止误附加 suite_access_token。与 WxCpTpOAServiceImpl、WxCpTpUserServiceImpl 等实现模式保持一致。
修改 WxCpTpService 接口 + BaseWxCpTpServiceImpl —— 新增 getWxCpTpMessageService() / setWxCpTpMessageService() 并完成默认初始化。
新增单元测试（WxCpTpMessageServiceImplTest）—— 使用 Mockito 验证 corpId 对应的 access_token 正确使用，以及 withoutSuiteAccessToken=true 参数正确传递；已纳入 testng.xml 测试套件。

使用示例

// corpId 为授权企业的 corpId，agentId 需调用方显式指定
WxCpMessage msg = WxCpMessage.TEXT()
    .agentId(agentId)
    .toUser("zhangsan")
    .content("Hello from TP app")
    .build();

WxCpMessageSendResult result = wxCpTpService.getWxCpTpMessageService()
    .send(msg, authCorpId);

与普通 WxCpMessageService 的核心区别：每次调用需显式传入 corpId，且调用方必须自行在消息中设置 agentId（TP 上下文中没有默认 agent 配置）。

Original prompt

This section details on the original issue you should resolve

<issue_title>企业微信第三方应用SDK封装模块？</issue_title>
<issue_description>
企业微信第三方应用中的service是否未封装完？例如发送消息是service没有找到，还是说公用

中的service。如果是公用，是如何初始化对象的？</issue_description>

Comments on the Issue (you are @copilot in this section)

Custom agent used: 全部用中文
需要用中文，包括PR标题和分析总结过程

Fixes 企业微信第三方应用SDK封装模块？ #3923

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot

Pull request overview

本次变更在 weixin-java-cp 的第三方应用（TP）能力中补齐“代授权企业发送/撤回应用消息”等消息推送相关接口，并将其挂载到 WxCpTpService 体系中，便于调用方通过统一入口获取消息服务。

Changes:

新增 WxCpTpMessageService 及其实现 WxCpTpMessageServiceImpl，支持发送消息、查询统计、互联企业消息、学校通知、撤回消息（均按 corpId 使用对应 access_token，并以 withoutSuiteAccessToken=true 发起请求）。
在 WxCpTpService / BaseWxCpTpServiceImpl 中新增并初始化消息服务的 getter/setter。
补充对应的 TestNG 用例并纳入 testng.xml 测试套件。

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
weixin-java-cp/src/test/resources/testng.xml	将新增的消息服务测试类加入 TestNG 执行列表
weixin-java-cp/src/test/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImplTest.java	新增消息服务单测，验证调用时 `withoutSuiteAccessToken=true` 且使用 corpId 对应 access_token
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpService.java	在 TP 总入口接口上新增消息服务的 get/set 声明
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpMessageService.java	新增第三方应用消息推送服务接口定义
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java	新增接口实现，封装消息相关 API 调用
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/BaseWxCpTpServiceImpl.java	初始化并暴露消息服务实例

augmentcode · 2026-03-17T02:47:51Z

🤖 Augment PR Summary

总结：本 PR 为企业微信「第三方应用（TP）」模块补齐了缺失的消息发送能力，提供与自建应用 WxCpMessageService 对齐的封装，但每个接口额外要求显式传入授权企业的 corpId。

变更内容：

新增 WxCpTpMessageService 接口：覆盖应用消息发送、消息统计、互联企业消息、学校通知、消息撤回等能力，并统一增加 corpId 入参
新增 WxCpTpMessageServiceImpl 实现：通过 configStorage.getAccessToken(corpId) 获取授权企业 access_token，并调用 post(url, data, withoutSuiteAccessToken=true) 避免自动拼接 suite_access_token
在 WxCpTpService / BaseWxCpTpServiceImpl 中新增并初始化消息服务的 getter/setter，便于统一入口访问
新增对应单元测试 WxCpTpMessageServiceImplTest，并加入 TestNG 测试套件

技术要点：TP 场景下没有默认应用上下文，调用方需要自行在消息体中设置 agentId，且接口请求需使用授权企业的 access_token（而非 suite_access_token）。

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 3 suggestions posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-03-17T02:47:52Z

+   * @return 消息发送结果
+   * @throws WxErrorException 微信错误异常
+   */
+  WxCpMessageSendResult send(WxCpMessage message, String corpId) throws WxErrorException;


TP 场景下如果消息体未显式设置 agentId（例如 WxCpMessage/WxCpLinkedCorpMessage/WxCpSchoolContactMessage），接口通常会直接返回参数错误；这里建议在接口 Javadoc 里明确“调用方必须自行设置 agentId”，避免误用。

Severity: low

Other Locations

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpMessageService.java:55

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpMessageService.java:71

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-03-17T02:47:52Z

+
+  @Override
+  public WxCpMessageSendResult send(WxCpMessage message, String corpId) throws WxErrorException {
+    String url = mainService.getWxCpTpConfigStorage().getApiUrl(MESSAGE_SEND)


这里用 + "?access_token=" 直接拼接 URL，若 getApiUrl(...) 在某些私有化/网关场景下已带查询参数，可能生成 ?? 导致请求失败；可以考虑按 uri.contains("?") ? "&" : "?" 的方式拼接以规避边界问题。

Severity: low

Other Locations

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java:35

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java:44

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java:52

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/impl/WxCpTpMessageServiceImpl.java:61

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

augmentcode · 2026-03-17T02:47:52Z

+   *
+   * @throws WxErrorException 微信错误异常
+   */
+  @Test


当前单测只覆盖了 send/recall 对 withoutSuiteAccessToken=true 的断言；为了避免后续改动时遗漏，建议为 getStatistics/sendLinkedCorpMessage/sendSchoolContactMessage 也补充同类校验。

Severity: low

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

binarywang · 2026-05-13T01:52:33Z

@copilot 更新当前PR的标题和描述为中文，并解决合并冲突

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot · 2026-05-13T01:56:01Z

@copilot 更新当前PR的标题和描述为中文，并解决合并冲突

已完成：

PR 标题和描述已更新为中文（通过 report_progress 更新）
testng.xml 的合并冲突已解决，保留了两侧新增的测试类（WxCpTpMessageServiceImplTest 和 WxCpHrServiceImplTest），对应提交 d3e49c2

Initial plan

4c65623

Copilot AI assigned Copilot and binarywang Mar 17, 2026

Copilot started work on behalf of binarywang March 17, 2026 02:28 View session

feat: 为企业微信第三方应用SDK添加消息发送服务（WxCpTpMessageService）

1f9f82c

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add encapsulation module for Enterprise WeChat SDK~~ feat(cp-tp): Add WxCpTpMessageService for third-party app message sending Mar 17, 2026

Copilot AI requested a review from binarywang March 17, 2026 02:39

Copilot finished work on behalf of binarywang March 17, 2026 02:39

binarywang marked this pull request as ready for review March 17, 2026 02:41

Copilot AI review requested due to automatic review settings March 17, 2026 02:41

Copilot started reviewing on behalf of binarywang March 17, 2026 02:42 View session

binarywang added this to the 4.8.3 milestone Mar 17, 2026

Copilot AI reviewed Mar 17, 2026

View reviewed changes

Comment thread weixin-java-cp/src/main/java/me/chanjar/weixin/cp/tp/service/WxCpTpService.java Outdated

augmentcode Bot reviewed Mar 17, 2026

View reviewed changes

Potential fix for pull request finding

97c8516

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

binarywang modified the milestones: 4.8.3, 4.8.4 May 11, 2026

Copilot started work on behalf of binarywang May 13, 2026 01:52 View session

合并 develop 分支，解决 testng.xml 冲突

d3e49c2

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>

Copilot AI changed the title ~~feat(cp-tp): Add WxCpTpMessageService for third-party app message sending~~ feat(cp-tp)：为企业微信第三方应用SDK添加消息发送服务（WxCpTpMessageService） May 13, 2026

Copilot finished work on behalf of binarywang May 13, 2026 01:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(cp-tp)：为企业微信第三方应用SDK添加消息发送服务（WxCpTpMessageService）#3931

feat(cp-tp)：为企业微信第三方应用SDK添加消息发送服务（WxCpTpMessageService）#3931
Copilot wants to merge 4 commits into
developfrom
copilot/add-enterprise-wechat-sdk-module

Copilot AI commented Mar 17, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

augmentcode Bot commented Mar 17, 2026

Uh oh!

augmentcode Bot left a comment

Uh oh!

augmentcode Bot Mar 17, 2026

Uh oh!

augmentcode Bot Mar 17, 2026

Uh oh!

augmentcode Bot Mar 17, 2026

Uh oh!

binarywang commented May 13, 2026

Uh oh!

Copilot AI commented May 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Copilot AI commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

变更内容

使用示例

Comments on the Issue (you are @copilot in this section)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

augmentcode Bot commented Mar 17, 2026

Uh oh!

augmentcode Bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

binarywang commented May 13, 2026

Uh oh!

Copilot AI commented May 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 17, 2026 •

edited

Loading