Skip to main content
agentscope-extensions-channel-wecom 通过加密回调机制将你的 Agent 接入企业微信(WeCom / WeChat Work)。一个 Spring @RestController 接收消息回调,解密后通过 Gateway 分发。

适用场景

  • Agent 需要响应企业微信机器人消息(单聊和群聊)。
  • 你的应用已经运行 Spring Boot。

添加依赖

前置准备

  1. 企业微信管理后台创建一个应用
  2. 启用接收消息 API 并配置回调 URL: https://your-host/api/channels/wecom/{channelId}/callback
  3. 记下 Corp IDAgent IDSecretTokenEncodingAESKey

快速开始

配置属性

加密

所有企业微信回调都是加密的。适配器使用 WeComCrypto 自动处理解密和签名校验,实现了企业微信回调加密规范

消息流转

入站: WeComCallbackController → URL 验证(echostr) → 解密 → MsgId 去重 → WeComInboundMapper(文本消息) → 防循环 → Gateway。 出站: WeComOutboundClient 通过 /cgi-bin/message/send(单聊)或 /cgi-bin/appchat/send(群聊)发送回复,使用 WeComAccessTokenProvider 获取 access_token