Probar la conexión
Comprueba que la plataforma llega a la API de tu sistema con las credenciales guardadas.
Probar consulta la API de tu sistema con la dirección y las credenciales que guardaste, y te dice si respondió y en cuánto tiempo. Úsalo después de crear una integración o de cambiar sus credenciales.
Antes de empezar
Necesitas el rol Editor o Administrador.
La integración debe tener URL base. Si no la tiene, el botón aparece desactivado y dice Configura la URL base para probar la conexión.
Pasos
Entra a Configuración → Integraciones.
En la tarjeta de la integración, presiona Probar.
Espera el resultado: aparece un aviso en la parte superior.
Se consulta la URL base seguida de la Ruta de salud que definiste; si la ruta está vacía, solo la URL base. La consulta es de solo lectura y espera hasta 10 segundos.
Resultados
Mensaje | Qué significa |
|---|---|
Conexión exitosa. (con el código HTTP y los milisegundos) | El sistema respondió bien. |
El sistema respondió … (con un código, por ejemplo 401) | Llegó al sistema, pero rechazó la consulta. Un 401 o 403 suele indicar una credencial incorrecta; un 404, una Ruta de salud que no existe. |
Sin respuesta en 10 s. | El sistema no respondió a tiempo. Revisa la URL base y que el sistema sea accesible desde internet. |
No se pudo conectar (con un código de red) | No se pudo abrir la conexión: dirección incorrecta, sistema apagado, firewall o certificado vencido. |
Las credenciales guardadas no se pueden descifrar… | Vuelve a escribir la credencial editando la integración. |
La URL base no es válida. o Solo se admiten URLs http o https. | Corrige la URL base editando la integración. |
No se pudo resolver el nombre del servidor. | El nombre de la URL base no existe en internet. Revisa que esté bien escrito. |
La URL apunta a una red privada; no se permite desde la plataforma. | La dirección es interna de tu red. La plataforma solo prueba sistemas accesibles desde internet. |
Qué pasa después
Si el sistema respondió (con éxito o con un código de error), la tarjeta actualiza Última sincronización. Si la prueba sale bien, el estado queda Activa.
Si el sistema respondió con un código de error, no respondió a tiempo o no se pudo conectar, el estado pasa a Error y la tarjeta muestra el motivo bajo el nombre. El estado vuelve a Activa con la siguiente prueba exitosa o cuando llega un evento nuevo por el webhook.
Si la URL base no es válida, no existe o apunta a una red privada, solo ves el aviso: el estado y las fechas de la tarjeta no cambian.
Probar una integración Pausada le cambia el estado: queda Activa si la prueba sale bien o Error si falla, y en ambos casos el webhook vuelve a aceptar eventos. Si quieres que siga pausada, vuelve a pausarla después de probar. Ver Editar, pausar o eliminar una integración.
Con OAuth 2.0 (client credentials), por ahora la prueba consulta tu sistema sin autenticarse. Si tu sistema exige autenticación en esa ruta, la prueba responderá con un código como 401 aunque las credenciales sean correctas.
La prueba no afecta la recepción de eventos: un sistema puede enviar eventos por el webhook aunque la plataforma no pueda llegar a su API.