企业微信集成测试时报错 60020，提示调用 WeChat Work Agent Info 接口失败

在观远 BI 管理后台配置企业微信集成时，填写 CorpId、AgentId、AppSecret 后点击测试连接，页面右上角提示：

`调用 WeChat Work Agent Info 接口失败，错误码：60020`

当前是在系统集成的企业微信配置页面进行测试，需要确认这个错误码代表什么，以及需要从哪些配置项排查。

企业微信错误码 `60020` 通常表示“不安全的访问 IP”，也就是 BI 服务端调用企业微信接口时，当前出口 IP 没有被企业微信应用的可信 IP 白名单放行。

这个问题一般不是 CorpId、AgentId、AppSecret 填错导致的。处理建议如下：

1. 确认观远 BI 服务端访问外网的出口公网 IP。可以在部署 BI 后端的服务器上执行：

```bash
curl ifconfig.me
```

也可以让客户运维确认 NAT、网关、代理后的实际出口 IP。

2. 在企业微信管理后台配置可信 IP。路径通常是：企业微信管理后台 -> 应用管理 -> 对应自建应用 -> 开发者接口 / 企业可信 IP，将 BI 服务端出口公网 IP 加入白名单。

3. 如果是集群或多节点部署，需要确认所有可能调用企业微信接口的节点出口 IP，并全部加入可信 IP。

4. 如果有防火墙、代理、私有化企微或 hosts 绑定，还需要确认 BI 服务端能正常访问：

```text
qyapi.weixin.qq.com
```

5. 配置完成后，回到 BI 管理后台重新点击测试连接。

企业微信集成配置可参考官方文档：
https://docs.guandata.com/product/bi/427296873406005248?_highlight=%E4%BC%81&_highlight=%E5%BE%AE&_highlight=%E9%9B%86%E6%88%90