安装类问题
Q：安装包运行时提示“Windows已保护你的电脑”
这是Windows SmartScreen的提示，因为美洽的代码签名证书更新后尚未完全同步到微软数据库。点击“更多信息”，然后选择“仍要运行”即可。从官方美洽下载页面获取的安装包是安全的。
Q：安装后启动闪退，没有任何提示
多数情况下是缺少VC++运行库。下载安装“Microsoft Visual C++ 2015-2022 Redistributable”（x64版本），重启电脑后再尝试启动美洽客户端。
Q：macOS提示“无法验证开发者”
打开“系统偏好设置”→“安全性与隐私”，在“允许从以下位置下载的应用”中点击“仍要打开”。或者使用右键点击美洽图标，选择“打开”，也可以绕过该提示。
登录与连接类问题
Q：登录时提示“企业子域名不存在”
企业子域名是你在注册美洽智能客服系统时设置的唯一标识，格式为yourcompany.meiqia.com。如果不记得，请联系管理员在后台“企业信息”中查看。注意不要输入完整的https://前缀。
Q：客户端提示“网络连接失败”，但浏览器可以上网
检查公司防火墙是否限制了美洽的服务器域名。需要放行的域名包括：*.meiqia.com、*.meiqia.cn以及WebSocket端口443。如果是私有化部署客户，需要确认内网地址是否正确。
Q：登录后看不到任何会话消息
确认你的账号是否被分配了客服角色。管理员在后台“成员管理”中可以为不同账号设置权限。只读账号或访客账号无法查看会话。
功能使用类问题
Q：消息发送延迟，客户收不到回复
首先检查本地网络。全渠道在线客服的所有消息都经过美洽服务器中转，如果本地上传带宽不足，会导致消息发送慢。其次，检查是否同时登录了多个客户端（网页+桌面），可能会有消息同步冲突。建议只保留一个活跃会话。
Q：大模型获客机器人没有主动发起对话
确认你的套餐是否包含大模型获客机器人功能（旗舰版及以上）。然后在后台“机器人设置”→“接待模式”中，将模式设为“机器人优先”或“混合模式”。如果是“人工优先”，机器人不会主动介入。
Q：通知弹窗不显示
Windows用户：检查系统通知设置中是否允许美洽发送通知。macOS用户：检查“通知与专注模式”中是否将美洽加入允许列表。同时确认客户端“设置”→“通知”中已开启。
升级与兼容性问题
Q：是否必须升级到最新版本
不是必须。美洽下载页面保留了历史版本，但建议升级以获得最新的稳定性修复和智能客服机器人优化。v7.1.0及更早版本的用户，如果遇到消息同步延迟问题，升级到v7.2.1可解决。
Q：Windows 7能否安装最新客户端
不能。v7.2.0及以上版本仅支持Windows 10/11 64位。如果你仍使用Windows 7或8.1，请在美洽下载页面的“历史版本存档”中获取v7.1.0。
总结
以上是美洽桌面客户端最常遇到的问题及解决方法。如果仍未解决，建议收集日志文件（Windows路径%AppData%\MeiQia\logs，macOS路径~/Library/Logs/MeiQia）并提交给美洽技术支持。正确的安装和配置是充分发挥全渠道在线客服和大模型获客机器人功能的基础。