常见问题排查手册

一、右下角不显示客服按钮

1. 确认代码在 </body> 之前，而不是 </head> 里。
2. 按 F12 打开控制台，看是否有红色报错（如 404 说明文件路径错）。
3. 直接访问代码里的地址（如 你的域名/kefu-embed.js），能打开说明路径对。
4. 清除浏览器缓存；若使用了 CDN（如 Cloudflare），还要清除 CDN 缓存。
5. 检查是否有其他 position:fixed 元素覆盖（组件 z-index 为 2147483000，一般不会被压住）。

二、HTTPS 站点不显示

HTTPS 页面加载 HTTP 资源会被浏览器拦截。解决方法：改用方式③（文件放你自己服务器），或把代码里的 http:// 改为 https://（前提是我们的服务器支持 HTTPS）。

三、点击按钮打开是空白

检查 Key 是否正确：把 /chat/window.php?k=你的KEY 粘贴到浏览器地址栏直接打开，如果提示"无效接入"说明 Key 有误或商户被禁用。

四、访客发消息我收不到邮件

1. 确认「对接设置」里的通知邮箱已填写并保存。
2. 确认当时确实没有客服在线（在线时不发邮件）。
3. 确认每个会话只通知一次（避免重复打扰）。
4. 用「邮箱设置 → 发送测试邮件」验证 SMTP。

五、多个网站数据串了

每个网站必须单独注册一个账号，使用各自的 Key。共用一个 Key 会导致所有站点的访客挤在同一商户下，无法区分来源。