故障排查
常见故障排查：入口、授权、发送与后台连接
按现象快速检查插件入口、会员授权、消息发送、定时任务、数据恢复和客服后台连接问题。
图 1：正常状态下，插件首页会显示版本、当前账号以及可用功能入口。
一、WhatsApp Web 看不到插件入口
依次检查：扩展管理页中 WA Toolkit 是否启用、浏览器版本是否达到 120、当前地址是否为 https://web.whatsapp.com、WhatsApp 聊天列表是否已经加载。
然后刷新 WhatsApp Web，并尝试点击浏览器工具栏中的扩展图标。如果仍不可见，在扩展管理页确认没有加载错误，并重新选择包含 manifest.json 的解压目录。
二、会员激活失败
- 重新复制完整卡密，移除前后空格和换行。
- 确认网络可以访问授权服务。
- 确认当前登录的是准备绑定的 WhatsApp 账号。
- 卡密已绑定其他账号或设备时，不要反复尝试，联系管理员处理解绑或授权范围。
不要通过截图公开完整卡密。
三、消息模板或活动发送失败
先查看界面显示的具体错误，再检查：WhatsApp Web 是否仍登录、聊天是否可以人工发送、附件是否超过单个 16 MB 或模板总计 32 MB、目标号码格式是否正确。
活动目标只有在 WhatsApp 确认后才会记为 sent。失败时不要把全部名单重新发送，以免已经成功的客户重复收到消息。
四、定时活动没有运行
定时任务按浏览器本地时区执行。确认电脑时间和时区正确，并保证到达计划时间时浏览器与已登录 WhatsApp Web 标签页保持打开、电脑没有休眠。
普通浏览器插件无法在电脑关机后继续执行 WhatsApp 私有 API。需要 24×7 时，应使用常开运行环境或服务端 Provider。
五、后台连接显示离线
检查会员授权是否有效、API 地址是否完整、公司连接令牌是否已过十分钟、当前账号是否停用，以及 WhatsApp 页面是否可用。
网络恢复后连接会按退避策略自动重试，不需要连续刷新页面。如果“后台连接在线”但“页面不可用”，请恢复或重新打开已登录的 WhatsApp Web 标签页。
六、备份无法导入
只导入由 WslinkDesk 导出的 JSON。文件超过限制、结构不正确或包含危险字段时，系统会拒绝导入且不修改现有数据。
连接令牌、Webhook Authorization 和自定义请求头不会随普通备份迁移，这是安全设计。恢复后需要重新检查这些连接配置。
七、联系在线客服前准备什么
仍无法解决时，点击官网右下角“在线客服”，提供：
- 使用的是单独插件、客服系统还是组合方案。
- 浏览器与插件版本。
- 出错页面和操作步骤。
- 界面显示的完整错误文字。
- 是否可以稳定复现。
不要发送会员卡密、公司连接令牌、Webhook 密钥、客户聊天内容或其他敏感数据。客服需要更多信息时会明确说明安全的提供方式。