接入常见问题
按配置、网络、身份和业务回执逐层定位。
问题与检查
| 问题 | 先检查 |
|---|---|
| 只有页面,没有回复 | 入口是否启用,智能体是否发布、资源是否可用,实际请求是否被接受 |
| 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.mdsdk/wechat-miniapp/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。