迁移旧版企微群机器人到新版应用消息没有自动切换功能，需要修改代码将 Webhook 请求替换为基于 access_token 的应用消息接口，适合需要更高安全性或更丰富消息类型的场景。
先说结论：必须重构消息发送代码，无法通过配置直接平滑切换，建议并行运行验证后再下线旧机器人。
- 适合：需要自定义发送者名称、使用更丰富消息卡片或加强安全鉴权的团队。
- 先准备：在企业微信管理后台创建自建应用，获取 CorpID、AgentID 和 Secret。
- 验收：确认新应用消息能正常送达群聊，且发送者身份显示为应用名称而非机器人。
快速处理思路
迁移本质是接口协议变更，不涉及服务器迁移，重点在于代码层面的鉴权逻辑改造。
- 保留旧 Webhook 地址作为备用，防止新接口调试期间消息丢失。
- 代码中增加 access_token 获取与缓存逻辑，避免每次发送都请求令牌。
- 新应用添加到群聊后，先发送测试消息，确认权限无误再切换流量。
为什么会这样
旧版群机器人基于简单 Webhook 密钥鉴权，新版应用消息基于 OAuth2 或 access_token 鉴权，两者底层接口完全不同。
旧版群机器人设计初衷是轻量级通知，安全性较低，密钥泄露风险大。新版应用消息属于自建应用范畴，支持更细粒度的权限控制和更丰富的消息模板（如模板卡片），因此企业微信要求通过创建应用的方式来管理消息发送身份，导致无法直接复用旧的 Webhook 地址。
分步处理
按以下步骤完成代码改造和灰度切换，确保业务通知不中断。
1. 创建自建应用
登录企业微信管理后台，进入「应用管理」创建自建应用，记录 CorpID、AgentID 和 Secret。确保应用可见范围包含需要接收消息的部门或成员。
2. 改造鉴权逻辑
移除代码中旧的 Webhook URL 调用，改为先请求 access_token。参考接口地址通常为https://qyapi.weixin.qq.com/cgi-bin/gettoken。将获取到的 token 缓存至 Redis 或本地内存，有效期通常为 7200 秒，过期前主动刷新。
3. 适配发送接口
调用应用消息发送接口，URL 通常为https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN。请求体需包含touser、toparty或totag，群聊消息需确保应用已添加到群且具备发送权限。
4. 灰度切换
先在测试群配置新应用发送消息，验证通过后，在生产环境将关键告警切换至新应用。观察 24 小时无异常后，移除旧版群机器人。
怎么验证是否生效
通过接收端显示信息和后台日志确认迁移结果。
- 发送者名称：群聊中消息发送者应显示为自建应用名称，而非「机器人」。
- 消息内容：检查 Markdown 或文本内容渲染是否正常，无乱码或截断。
- 后台日志：在企业微信管理后台「应用管理」查看调用日志，确认无频繁鉴权失败报错。
- 接收状态：确认目标成员或群聊能正常收到消息，无「该应用不可见」提示。
常见坑
- Token 缓存失效：未处理 access_token 过期逻辑，导致消息发送 intermittent 失败。
- 消息类型不兼容：旧版支持的某些 Markdown 语法在新版应用消息中可能渲染效果不同，需提前测试。
- 群权限不足：自建应用添加到群聊后，默认可能无发言权限，需在群设置中确认应用权限。
- 频率限制差异：新版应用消息的频率限制与旧版机器人不同，高频通知需增加本地队列削峰。
常见问题
旧版机器人 Webhook 还能继续用吗？
可以继续使用，但建议逐步淘汰，因为官方更推荐自建应用模式以获得更好支持。
迁移后历史消息记录会丢失吗？
不会丢失，历史消息保留在群聊记录中，但新消息的发送者身份会变为新应用名称。
应用消息支持发送给外部群吗？
不支持，自建应用消息通常仅限企业内部成员或已认证的外部联系人，具体需查看最新接口文档权限说明。
参考来源
- 企业微信开放文档 - 发送应用消息
- 企业微信开放文档 - 群机器人