agentscope-extensions-channel-wecom 通过加密回调机制将你的 Agent 接入企业微信(WeCom / WeChat Work)。一个 Spring @RestController 接收消息回调,解密后通过 Gateway 分发。
适用场景
- Agent 需要响应企业微信机器人消息(单聊和群聊)。
- 你的应用已经运行 Spring Boot。
添加依赖
前置准备
- 在企业微信管理后台创建一个应用。
- 启用接收消息 API 并配置回调 URL:
https://your-host/api/channels/wecom/{channelId}/callback - 记下 Corp ID、Agent ID、Secret、Token 和 EncodingAESKey。
快速开始
配置属性
加密
所有企业微信回调都是加密的。适配器使用WeComCrypto 自动处理解密和签名校验,实现了企业微信回调加密规范。
消息流转
入站:WeComCallbackController → URL 验证(echostr) → 解密 → MsgId 去重 → WeComInboundMapper(文本消息) → 防循环 → Gateway。
出站: WeComOutboundClient 通过 /cgi-bin/message/send(单聊)或 /cgi-bin/appchat/send(群聊)发送回复,使用 WeComAccessTokenProvider 获取 access_token。