开发者文档中心

OpenAPI进入控制台

排错与更新记录 · 2026-10-31

接入常见问题

按配置、网络、身份和业务回执逐层定位。

问题与检查

问题先检查
只有页面,没有回复入口是否启用,智能体是否发布、资源是否可用,实际请求是否被接受
Web SDK 提示不同源必须相同 HTTPS origin;异域站点改用生成的 widget / iframe
小程序开发工具可用,手机不可用正式 request / upload / download 域名、证书、基础库、实际 wx API
App 页面被拒绝专用渠道是否适合无 Referer;不要删除原网站白名单或伪造头
切账号仍看到旧聊天旧实例是否 forgetSession + destroy,原生页面是否销毁,scope 是否更新
“转人工”后仍在等待人工组、服务时间、在线客服和实际接管状态;请求入队不是接管完成
附件不能预览服务端类型/大小、访客范围、宿主文件能力;不泄露令牌给外部 URL
扫码授权 / 推送 / openid 不可用检查该端能力表,不把供应商功能当作云蝠已实现功能

提交诊断材料

提供平台及版本、入口 ID、复现时间、脱敏错误码 / 请求 ID、实际步骤和预期结果。不要发送 API Key、AppSecret、访客令牌或客户完整敏感信息。

实现依据 · 仓库内路径
  • sdk/client-kit/README.md
  • sdk/wechat-miniapp/README.md

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。