Una integración no se conecta

"Clave de API inválida: autenticación rechazada por el servicio remoto"

La clave en sí fue rechazada por el servicio al que te conectas, no por HeartBeatAgents. Regenera la clave en el propio sitio de ese servicio e inténtalo de nuevo; un error de copiar y pegar (un espacio al final, una clave truncada) es la causa más común.

"El dominio no está verificado"

Algunos servicios (los remitentes de correo en particular) solo te permiten usar un dominio ya verificado en su lado. Verifica primero el dominio en el propio panel de ese servicio; el error nombra los dominios ya verificados, si los hay, para que puedas confirmar que apuntas al correcto.

"Por favor completa tanto el ID de cliente como el secreto de cliente"

Para una aplicación OAuth personalizada, ambos campos son obligatorios antes de que pueda iniciar el flujo de conexión; una descripción de servicio con solo un ID de cliente (o solo un secreto) no puede autenticarse.

La conexión expira, o "No se puede conectar a {host}"

Este es un problema de accesibilidad de red a ese host específico, no un problema de autenticación. Confirma que el host es realmente correcto (un error tipográfico en el host de API de una integración personalizada es una causa común) y accesible desde donde se ejecuta esta instancia.

"Sesión expirada: por favor inicia sesión de nuevo"

Esto interrumpe específicamente un flujo OAuth, no tu sesión de HeartBeatAgents en general. Vuelve a iniciar la conexión desde Configuración → Integraciones.

La prueba de conexión pasa, pero la integración sigue sin funcionar para un agente

Una prueba exitosa solo confirma que la credencial en sí es válida; no confirma que se le haya dado acceso a un agente. Revisa Configuración → Integraciones → [ese servicio] → Asignar a agentes para confirmar que el agente que esperas está realmente vinculado a ella.

Relacionado

• Guía de integraciones: cómo se supone que funciona conectar un servicio
• Integraciones personalizadas: el paso de verificación específico de una integración autodefinida
• Un agente se queda atascado en un bucle de reintentos: cuando una integración que antes funcionaba empieza a fallar a mitad de conversación