某个集成无法连接

一个具体的连接错误实际意味着什么，从被拒绝的 API 密钥到未验证的域名，以及如何解决它。

“无效的 API 密钥：认证被远程服务拒绝”

密钥本身被你所连接的服务拒绝了，而不是被 HeartBeatAgents 拒绝。在该服务自己的网站上重新生成密钥并重试；复制粘贴错误（多余的空格、被截断的密钥）是最常见的原因。

某些服务（尤其是邮件发送方）只允许你使用已经在其一侧验证过的域名。先在该服务自己的控制面板中验证域名；错误消息会指出已验证的域名（如果有的话），以便你确认自己指向的是正确的域名。

对于自定义 OAuth 应用，两个字段在连接流程开始之前都是必填的；只填了客户端 ID（或只填了密钥）的服务描述无法完成身份验证。

这是对该特定主机的网络可达性问题，而不是身份验证问题。确认主机确实正确（自定义集成 API 主机中的拼写错误是常见原因），并且该实例所在的环境能够访问它。

这具体中断的是一次 OAuth 流程，而不是你整体的 HeartBeatAgents 会话。从设置 → 集成重新开始连接。

成功的测试只能确认凭证本身有效；它不能确认某个智能体已被授予访问权限。检查设置 → 集成 → [该服务] → 分配给智能体，确认你期望的智能体确实已绑定到它。