美洽只收不到某个访客的消息，应该怎样做对照排查？

遇到美洽只收不到某个访客的消息，应按优先级逐项排查：核对访客信息；检查账号与权限；确认网络与防火墙；核查消息过滤与黑名单；查看会话状态与日志，并联系美洽技术支持。必要时重置会话或更新应用版本，以及验证第三方集成配置是否正常。并记录结果观测。

美洽：访客信息与基础资料核对

检查访客手机号与邮箱是否填写正确

• 核对联系方式：确认访客在美洽填写的手机号码、邮箱及其他联系方式与实际一致，排除国家码、空格或字符错误等格式问题导致消息无法投递。
• 验证渠道标识：若访客来自公众号、小程序或第三方渠道，核对渠道ID与绑定信息，确保消息被路由到正确的会话与客服账号。
• 确认访客身份：检查访客是否使用临时ID或重复账号，必要时要求访客重新提交信息或使用不同方式建立会话来验证问题是否复现。

校验会话ID与访客标签是否异常

• 查看会话标识：在美洽后台检索该访客的会话ID，确认该会话仍处于开启或有效状态，而非已关闭、合并或删除导致消息无法到达。
• 核查访客标签：检查是否存在误配置的标签或规则把该访客归入特殊分组，从而触发消息屏蔽或自动拦截。
• 重建会话尝试：在确认会话状态异常时，指导访客发起新的会话或清除本地缓存后重新进入，观察是否能够恢复消息接收。

美洽：账号权限与接入配置排查

确认客服账号权限与分配是否正确

• 检查客服权限：在美洽后台查看对应客服账号是否被赋予接收外部访客消息的权限，必要时临时提升权限做排查验证。
• 核对工单与角色：确认访客消息是否被自动转为工单或分配给其它角色，导致目标客服未收到提醒或消息未显示在当前会话中。
• 复位账号状态：如发现账号异常，尝试注销重登或由管理员重置该客服的会话分配与通知设置，排查是否为账号缓存导致的问题。

检查第三方集成与接口调用配置

• 核实API回调：如果使用第三方回调或自定义接入，检查回调URL、签名与返回码，确保第三方未阻断或报错导致美洽无法正确接收或展示消息。
• 验证Webhook权限：确认Webhook在美洽侧和目标服务间的认证信息匹配，若认证失败会导致消息传递中断，需在日志中查找401/403类错误。
• 检查版本兼容：如有自研中间件或SDK，验证其版本与美洽当前接口兼容性，必要时升级SDK或回退到稳定版本进行验证。

美洽：网络连通性与防护策略检测

测试客服与访客双方的网络连接情况

• 确认网络可达：要求客服与访客分别测试网络连通性（如ping/trace）、切换移动网络或Wi‑Fi排查局部网络问题是否导致消息丢失或延迟。
• 排除代理与VPN：查看是否因使用代理、VPN或公司网络策略造成对美洽服务的阻断或不稳定，建议在直连网络下重试以确认问题来源。
• 检查客户端网络限制：确认访客使用的浏览器或客户端是否有限制后台消息推送或长连接的设置，必要时清理缓存或重启客户端重连。

核查防火墙、WAF及安全策略是否拦截

• 查看防火墙策略：在企业侧或云端检查防火墙、WAF规则是否阻断了美洽的IP段、端口或长连接请求，调整白名单以确保消息通畅。
• 检索安全日志：从防火墙与入侵检测系统获取拦截记录，重点检查拒绝连接、重置或异常速率限制等日志条目以定位阻断节点。
• 短期策略放宽：为排查问题，可临时放宽相关安全规则并观察消息恢复情况，确认后再精细化设置以兼顾安全与可用性。

美洽：消息规则、黑名单与过滤机制排查

检查美洽系统中的消息过滤与关键字规则

• 核查敏感词规则：确认美洽后台是否启用了敏感词或自动过滤规则，某些关键字可能导致消息被拦截或标记为垃圾信息。
• 检查自动化脚本：若配置了自动回复或机器人脚本，确认脚本逻辑没有错误地拦截或修改访客消息，导致客服端未能看到原始内容。
• 暂时禁用过滤：为定位问题，可在安全可控范围内暂时禁用部分过滤规则，观察该访客消息是否被正常接收以确定过滤为问题根源。

核实黑名单与灰名单设置是否影响该访客

• 查询黑名单记录：在美洽后台检索该访客是否被错误地加入黑名单或灰名单，若在名单中需先移除并告知访客再次尝试发送消息。
• 分析拦截原因：查看被拉入名单的具体原因（如投诉、垃圾行为判定），评估是否存在误判并进行人工复核与恢复。
• 调整自动判定阈值：若频繁出现误判，建议优化黑名单判定规则或降低误判敏感度，避免正常访客被误拦截影响业务。

美洽：日志排查与联系技术支持步骤

开启并下载美洽会话与系统日志进行分析

• 导出会话日志：在美洽后台导出该访客相关会话与消息交互日志，重点查看时间戳、消息状态与系统返回码以追踪消息流转链路。
• 检查错误码与异常：在日志中定位400/500类或超时、连接断开等异常记录，结合时间点与访客操作还原异常发生的前因后果。
• 保存证明材料：将关键日志、截图与访客说明整理为问题证据，便于与美洽技术支持快速定位并进行协同排查处理。

联系美洽技术支持并提供必要信息与复现步骤

• 准备问题清单：在联系美洽支持前，准备访客ID、会话ID、时间范围、截图及日志片段等信息，便于工程师快速复现与定位。
• 描述复现步骤：明确列出可重复触发问题的步骤、环境（浏览器、版本、网络）与是否每次出现，帮助支持团队判断问题范围与优先级。
• 请求临时排查权限：如需美洽方介入数据库或系统层面排查，可申请临时日志提升或内网诊断权限，并约定处理时限与反馈频率。