补充企业微信智能机器人 API 模式 JSON 回调消息模型与服务调用入口

[Copilot]

当前 weixin-java-cp 已覆盖智能机器人管理与会话相关服务端 API，但对文档（path/101039 / path/100719）中的 API 模式 JSON 回调消息体缺少统一模型，接入侧需要自行拼装解析。
本 PR 在不扩展不存在接口的前提下，补齐官方回调结构的 SDK 级解析能力，并补充服务层统一调用入口。

• 新增回调消息模型（intelligentrobot 包）

  • 新增 WxCpIntelligentRobotMessage
  • 覆盖官方回调关键字段：msgid、aibotid、chatid、chattype、from、response_url、msgtype
  • 覆盖消息载荷结构：text / image / mixed / voice / file / video / quote / stream
  • 提供 fromJson / toJson，统一接入方序列化与反序列化入口

• 新增服务调用入口（反馈补充）

  • 在 WxCpIntelligentRobotService 新增 parseCallbackMessage(String callbackMessageJson)
  • 在 WxCpIntelligentRobotServiceImpl 完成实现，内部基于 WxCpIntelligentRobotMessage.fromJson(...) 解析
  • 使调用方可通过 wxCpService.getIntelligentRobotService() 直接解析回调消息，而不必手动依赖模型静态方法

• 补充契约测试（JSON 结构稳定性）

  • 新增 WxCpIntelligentRobotMessageTest
  • 覆盖文本消息解析、mixed+quote 复合结构解析、序列化回归校验
  • 在 WxCpIntelligentRobotServiceImplTest 新增 testParseCallbackMessage，覆盖服务入口调用路径

• 文档更新（接入路径补全）

  • 更新 weixin-java-cp/INTELLIGENT_ROBOT.md
  • 将 JSON 回调示例调整为通过 robotService.parseCallbackMessage(jsonBody) 调用，明确 SDK 推荐入口

示例：

WxCpIntelligentRobotMessage callbackMessage =
    robotService.parseCallbackMessage(jsonBody);

String botId = callbackMessage.getAiBotId();
String userId = callbackMessage.getFrom().getUserid();
String msgType = callbackMessage.getMsgType();

if ("text".equals(msgType) && callbackMessage.getText() != null) {
  String content = callbackMessage.getText().getContent();
}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 93417276dc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Capture media aeskey in callback payloads

For image/file/video callbacks, WeCom sends the download URL together with an aeskey used to decrypt the downloaded media. These media payload classes only retain url, so fromJson() silently drops the key and callers receiving encrypted image, file, or video messages cannot use the SDK model to decrypt the media without reparsing the raw JSON.

Useful? React with 👍 / 👎.

[Copilot]

Pull request overview

本 PR 为 weixin-java-cp 的企业微信「智能机器人」能力补齐 API 模式 JSON 回调消息体的 SDK 级模型与解析入口，降低接入侧自行拼装/解析 JSON 的成本，并提供契约测试与文档示例以稳定回归。

Changes:

• 新增 WxCpIntelligentRobotMessage：覆盖回调公共字段及多种消息载荷结构，并提供 fromJson/toJson 统一序列化入口。
• 新增 WxCpIntelligentRobotMessageTest：覆盖文本与 mixed+quote 复合结构解析及序列化回归。
• 更新 INTELLIGENT_ROBOT.md：补充 API 模式 JSON 回调解析示例与文档排版修正。

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/intelligentrobot/WxCpIntelligentRobotMessage.java	新增智能机器人 API 模式 JSON 回调消息模型，提供 Gson 序列化/反序列化入口
weixin-java-cp/src/test/java/me/chanjar/weixin/cp/bean/intelligentrobot/WxCpIntelligentRobotMessageTest.java	新增契约测试，验证 JSON 解析与序列化回归
weixin-java-cp/INTELLIGENT_ROBOT.md	补充 JSON 回调解析示例并修正文档列表格式

[binarywang]

@copilot 这个新增的模型要如何调用？没有入口吗？

[Copilot]

@copilot 这个新增的模型要如何调用？没有入口吗？

已补上统一入口：wxCpService.getIntelligentRobotService().parseCallbackMessage(jsonBody)，内部会解析为 WxCpIntelligentRobotMessage。同时补了对应测试与文档示例。提交：2782478