目录大纲
当企业发现网站或应用中的美洽客服图标显示为离线、提示“当前暂无客服在线”或出现连接失败时，通常并非云端服务中断，而是由于配置冲突或网络通信链路受阻所致。导致该现象的四个最核心诱因为：坐席工作时间段规则生效、客服分组达到接待并发上限、局域网安全策略或代理拦截了长连接通信、以及同账号多端登录导致的状态互斥踢线。通过对这四个维度进行针对性排查，绝大多数状态异常可在数分钟内恢复正常。
美洽离线故障快速排查矩阵
在深入具体技术细节前，建议管理员对照下表快速缩小排查范围，识别具体是业务规则拦截还是网络传输层阻断：
| 排查维度 | 典型故障现象 | 高发诱因 | 快速确认方式 |
|---|---|---|---|
| 工作时间设置 | 非工作时间准时显示离线，或换班后未自动上线 | 系统全局或部门工作时间段生效，节假日未配置特殊排班 | 在工作台后台查看【设置】>【工作时间】对应规则 |
| 分组接待上限 | 白天正常，业务高峰期突然部分或全部访客显示离线 | 分组内所有坐席当前接待人数达到预设上限（Quota Limit） | 查看坐席当前对话数与【分流设置】中的最大接待限制 |
| 网络与代理拦截 | 坐席显示登录中、频繁掉线或提示“美洽连接失败” | 企业防火墙、VPN或代理服务器阻断了 WebSocket / SSL 长连接 | 切换坐席终端至手机热点，测试是否恢复稳定在线 |
| 多端登录冲突 | 桌面端刚上线即被弹出，移动端与PC端状态反复切换 | 同一账号在多台设备重复登录，安全策略触发踢线互斥 | 确认该账号是否被其他成员共享或多设备挂载 |
四大核心离线原因与详细排查步骤
1. 坐席工作时间段与排班规则配置
企业客服后台普遍配置了自动化排班规则。根据 美洽客服 的逻辑机制，当开启“工作时间”管理后，一旦超出设定时段，系统会自动将访客端窗口置为“离线留言”状态，即便后台有坐席依然挂着工作台也是如此。
- 检查路径：进入美洽管理后台，依次点击【设置】>【客服与分组】>【工作时间】。
- 排查要点：核对时区设置是否正确、是否存在跨午夜时间段配置错误；检查节假日特殊排班开关是否被误激活。
- 解决措施：若需全天候接待，可暂时关闭工作时间限制，或调整为仅下班时段提示机器人托管，而非彻底切断会话入口。
2. 客服分组接待上限与自动分流机制
为了保障服务质量，系统允许企业设置“坐席最大接待人数”。当指定路由分组中的所有在线坐席都达到该饱和值时，如果未配置“排队机制”或“自动转接未分组”，系统默认为了防止坐席崩溃，会向新增访客直接呈现“离线”状态。
- 检查接待配额：在【设置】>【对话分配规则】中，检查“坐席同时接待上限”。
- 排查路由指向：确认网站代码绑定的 Group ID（分组编号）是否准确。如果将访客指定分配给“售后组”，而售后组恰好无人在岗或全部满载，即便“售前组”全员空闲，访客端依然会判定为离线。
- 优化方案：开启“会话排队”功能，或开启溢出转接规则，确保高负载时不直接呈现离线提示。
3. 网络代理、防火墙与 WebSocket 连接拦截
现代 Web 实时通信高度依赖长连接。维基百科（Wikipedia）在对 WebSocket 协议的论述中指出，企业级代理（Proxy）或深度数据包检测（DPI）防火墙如果未正确配置长连接保持（Keep-Alive）与握手放行，容易导致连接悄默中断或建立失败。
IT 技术论坛 Reddit 的网络管理员板块常有讨论指出：企业网关的 SSL 审查（SSL Inspection）与第三方防病毒软件过滤，是造成实时 SaaS 客服终端出现“心跳包丢失、假在线但消息发不出”的第一大外部诱因。
- 自检网络环境：尝试让坐席断开企业局域网/内网代理，直接连接手机 4G/5G 个人热点。若热点环境下状态恢复正常，则百分之百属于局域网策略拦截。
- 放行必要端口与域名：联系网络管理员，在路由器或防火墙中将美洽通信域名（*.meiqia.com）加入白名单，并确保开放
443端口的 WebSocket（WSS）握手权限。 - 客户端更新：如果是独立客户端运行异常，建议前往 美洽客服官网下载 页面重新安装最新稳定版本，以修复旧版本可能存在的底层网络库兼容问题。
4. 账号多端同时登录引发的状态顶替冲突
为了保障数据安全性与对话权责明确，客服系统严禁多人共用同一坐席账号。如果某位坐席同时在 Windows 客户端、网页端以及移动端 App 登录，部分网络环境下可能会引发心跳包抢占冲突，导致系统在“在线-忙碌-离线”之间频繁跳变。
- 排查措施：进入【系统日志】查看目标坐席的登录日志，是否有异地 IP 或不同 User-Agent 的频繁登录踢线记录。
- 解决措施：遵循“一员一号”原则，禁用多处共用；在下班或切换设备时，主动点击“退出登录”，避免后台休眠进程持续向服务器发送错误的心跳指令。
常见问题
客服在美洽工作台显示“在线”，为什么访客端依然提示“离线留言”？
这种情况绝大多数由分组绑定错误或接待满载引起。前端页面代码中通常指定了特定的 group_id，如果该特定分组内的坐席未在线，或者该组坐席已达到最大并发接待数且未开通排队功能，即便其他公共坐席在线，访客端也会严格按照代码指定的分组状态显示为离线。
企业局域网环境下经常频繁掉线、连接失败，如何排查？
建议首先检查本地电脑是否开启了系统级网络代理软件、网络调试工具（如 Fiddler/Charles）或管家类安全软件。其次，排查企业路由器是否启用了较为激进的 TCP 连接超时释放机制。将美洽相关域名加入防病毒软件与网关的白名单，并保持客户端更新至最新版本即可解决大部分网络阻断。
美洽手机端 App 与 PC 客户端能否同时在线接收消息？
系统支持移动端与桌面端的协同在线，但需确保在个人设置中未勾选“桌面端在线时手机端静音/下线”的互斥选项。此外，若手机端开启了激进的电池省电模式，系统后台进程被杀可能导致长连接中断，建议在手机系统权限中为应用开启“允许后台运行”和“自启动权限”。
