把浏览器插件连接到 WslinkDesk 客服系统

一、什么时候需要连接

单独插件的数据默认保存在当前浏览器。当你需要多人共享会话、统一客户资料、负责人、权限和审计时，再把插件连接到客服系统。

连接后，插件仍负责 WhatsApp Web 当前账号上下文和浏览器侧动作；客服系统负责共享会话、客户数据和团队流程。不要把插件本地数据当作团队唯一数据源。

图 1：连接完成后，在客服系统会话中心验证账号、会话和消息是否进入正确工作区。

二、在客服后台准备连接

由管理员完成：

1. 在“账号管理”新增或选择 WhatsApp 账号。
2. 连接方式选择“浏览器扩展通道”。
3. 获取客服后台 API 地址和公司连接令牌。
4. 确认当前成员有权管理该账号和连接配置。

连接令牌是短期接入凭据，默认十分钟有效。只在对应插件中使用，不要通过群聊、截图或公开文档传播。

三、在插件中连接

1. 打开并登录目标 WhatsApp Web 账号。
2. 打开 WslinkDesk 插件面板。
3. 确认“会员授权”有效，且组合方案所需模块已开通。
4. 进入“后台连接”。
5. 填写后台 API 地址和公司连接令牌。
6. 点击“保存并连接”。
7. 等待状态显示“后台已连接”。

插件会读取当前 WhatsApp 登录号码，并创建或复用后台账号。首次成功后，系统会将临时连接令牌换成账号和设备绑定的短期会话，正常续期无需反复复制令牌。

四、验证完整链路

使用专门的测试联系人：

1. 从客户侧给当前 WhatsApp 账号发送文字。
2. 在客服系统“会话中心”确认消息进入正确账号。
3. 从客服系统回复一条测试文字。
4. 在 WhatsApp 客户侧确认收到。
5. 在会话中设置负责人、标签或备注，并刷新确认保存。
6. 暂时断开网络再恢复，观察连接能否自动恢复。

只有两个方向的消息都成功，才算链路完成。

五、理解在线状态

浏览器运行时，扩展 Service Worker 负责实时连接，WhatsApp 页面负责执行消息命令。两种状态需要同时正常：

• 后台连接在线：系统能够与插件交换事件和命令。
• WhatsApp 页面可用：存在已登录、可执行的 WhatsApp Web 标签页。

浏览器关闭、系统休眠或所有 WhatsApp 标签被浏览器丢弃后，页面无法执行消息。严格 24×7 运行需要专用常开浏览器、桌面代理或服务端 Provider，而不是依赖普通员工电脑。

六、解除或重新连接

许可证失效、账号停用或重新绑定设备后，旧会话会失效。需要重新连接时，先在后台确认目标账号和设备，再生成新的连接信息；不要继续重复使用已经过期的公司连接令牌。