1、创建机器人选择“API模式创建”时提示“服务器返回失败”

原因：链路已通（网络物理连接正常即网络可用），但服务器在接收到请求后，返回了非200 OK的HTTP 状态码（如 403,404,500 等）

解决办法：检查后端日志或网络层日志，确认服务器是否收到了请求，并查看报错日志定位业务逻辑错误。

2、创建机器人选择“API模式创建”时提示“网络连接失败”

原因：智能机器人尝试连接你的服务器 URL，但在 TCP 握手阶段失败，说明请求被拦截。

解决办法：
（1）公网连通性： 确认提供的 URL 在公网环境下可被访问（可尝试用手机流量访问测试）。
（2）防火墙策略： 检查服务器防火墙（如安全组、iptables）是否拦截了请求。
（3）证书问题： 若使用 HTTPS，请确保 SSL 证书有效且配置正确，非自签名证书或已过期证书。

3、创建机器人选择“API模式创建”时提示“不支持内网URL”

原因：填写的域名地址解析到了私有地址段（如 192.168.x.x、10.x.x.x、127.0.0.1 或 localhost），智能机器人无法从公网访问内网环境。

解决办法：更换为公网域名，请使用具备公网访问的域名。

4、创建机器人选择“API模式创建”时提示“服务器返回有误”

原因：没有返回解密后的明文echostr

解决办法：请参考API文档作出正确的响应。

5、创建机器人时出现报错提示“服务没有正确响应，请确认后重试”

若创建机器人时选择“API模式创建”，需验证URL有效性，请按照API文档指引正确响应企业微信的请求，或者参考API文档。
注：
（1）url填写的链接不支持内网链接或内网ip，内网链接/ip会提示“网络连接失败”。
（2）若是使用了第三方平台的教程服务进行配置，请咨询对应的第三方。

6、mac端创建智能机器人提示“登录超时，请重试”

请在mac端同时按下command+shift+control+D->进入debug模式->点击左上角调试->浏览器、webView相关->Webview类型设置->勾选使用后台配置（使用WKWebview），再操作。