登录失败的几种典型情况
使用美洽桌面客户端时，偶尔会遇到登录失败的问题。以下是最常见的四种情况及其解决方法。
情况一：提示“企业子域名不存在”
现象：输入账号密码后，系统提示“企业子域名不存在”或“未找到该企业”。
原因：企业子域名是注册美洽智能客服系统时设置的企业唯一标识，格式为yourcompany.meiqia.com。很多用户会错误地输入完整的网址（如https://yourcompany.meiqia.com）或遗漏后缀。
解决方法：
-
确认子域名格式：只需要输入
yourcompany部分（即企业简称），不需要输入.meiqia.com后缀。 -
如果不记得子域名，联系企业管理员登录美洽后台，在“企业信息”中查看。
-
如果是首次登录，检查注册时收到的邮件或短信，里面包含子域名信息。
情况二：提示“网络连接失败”
现象：客户端提示“网络连接失败，请检查网络设置”，但浏览器可以正常上网。
原因：美洽客户端需要访问特定域名和端口，可能被公司防火墙或代理服务器拦截。
解决方法：
-
确认防火墙已放行以下域名：
*.meiqia.com、*.meiqia.cn、wss.meiqia.com（用于WebSocket长连接）。 -
如果公司使用代理服务器，在美洽客户端“设置”→“网络”中配置代理地址和端口。
-
私有化部署客户需要确认客户端配置的服务器地址是否正确，且内网可达。
情况三：提示“账号或密码错误”
现象：输入正确的账号密码后仍提示错误。
原因：可能是大小写敏感、密码过期、或者使用了手机号而非邮箱登录。
解决方法：
-
美洽账号支持手机号或邮箱两种登录方式，尝试切换登录方式。
-
点击“忘记密码”通过注册邮箱或手机号重置密码。
-
检查键盘CapsLock是否开启，或尝试在记事本中输入密码后复制粘贴。
-
如果是企业通过SSO单点登录，需要使用企业统一认证入口，而非直接输入密码。
情况四：登录后看不到任何会话消息
现象：登录成功，但工作台为空，没有历史会话记录。
原因：当前账号没有被分配客服角色，或者权限被设置为“只读”。
解决方法：
-
联系企业管理员，在美洽后台“成员管理”中检查你的角色。客服人员需要被分配到“客服”或“管理员”角色。
-
如果是新创建的账号，可能还没有被分配到任何技能组。管理员需要将你添加到对应的客服组。
-
私有化部署环境下，确认账号状态是否为“已激活”。
其他注意事项
-
多设备登录：美洽客户端支持同时在电脑和手机上登录，但如果同一设备类型登录多个客户端，后者会踢掉前者。
-
版本兼容性：如果使用的是旧版本客户端，可能会因API变更导致登录失败。建议从美洽下载页面获取最新版本v7.2.1。
-
服务器维护：极少数情况下，美洽公有云服务会进行例行维护。可以访问
status.meiqia.com查看服务状态。
仍无法登录怎么办？
如果以上方法都无法解决问题，请收集以下信息后联系美洽技术支持：
-
客户端版本号（在登录界面左下角查看）
-
操作系统版本（Windows 10/11 或 macOS版本）
-
错误提示的完整截图
-
客户端日志文件（Windows路径：
%AppData%\MeiQia\logs；macOS路径：~/Library/Logs/MeiQia）
确保美洽下载的客户端版本为官方最新版，可避免大部分兼容性问题。