错误码与排查

排查顺序固定为：凭证 → 实例在线 → 参数 → 频率 → 外部资源。先确认哪一层失败，再查看具体接口页的错误响应。

快速判断

现象	首先检查	相关文档
返回未认证或无权限	API 凭证、Bearer 格式、应用状态	登录方式与 API 凭证
扫码失败或快速掉线	登录城市、原 wcId、网络方式	登录与测试流程
发送失败	wId 在线状态、目标 wcId、发送频率	发送错误码
回调收不到	公网可访问、路径、响应时间、实例在线	Webhook 本地联调
媒体处理慢	文件源速度、格式、队列和异步结果	API 使用与安全

保留哪些诊断信息

• 请求时间、接口路径和业务请求 ID。
• 脱敏后的 wId、目标类型和响应 code。
• 微信实例在线状态和最近掉线原因。
• Webhook 的 messageType、newMsgId 和处理耗时。

不要在诊断信息中记录完整 API 凭证、密码或无关的消息正文。