Verificación y monitoreo

Quralo verifica que la integración con tu sistema de salud funcione, tanto de forma manual (botón "Probar conexión") como automática (monitoreo periódico). Esta página explica los estados, qué valida cada check, cómo funcionan las notificaciones por email y las IPs de salida.

Estados de la integración

Estado	Significado
draft	Creada, sin verificar (recién creada, o después de regenerar claves).
active	La última verificación fue exitosa.
error	La última verificación falló.
disabled	Integración deshabilitada/eliminada.

"Probar conexión" (verificación manual)

El botón "Probar conexión" ejecuta el mismo check que el monitoreo automático, pero al instante. Es la vía rápida para validar un cambio de configuración o probar las notificaciones.

Lo que hace:

1. Resuelve el token endpoint (por configuración manual o auto-descubrimiento desde .well-known/smart-configuration).
2. Obtiene un access token (OAuth Client Credentials + Private Key JWT).
3. Consulta GET {fhir_base_url}/metadata con Authorization: Bearer <token>.

Resultados:

• Éxito = token válido + /metadata responde y reporta fhirVersion == 4.0.1 (y, si se configuraron, los recursos requeridos). Marca active y guarda la fecha del último check.
• Fallo = marca error y guarda el mensaje de error.

En la UI, la vista muestra el estado con un indicador:

• ● Activa — cuando está OK.
• ● Con errores — con el detalle y la fecha del último check (la UI lo muestra como "Último check: ...").

Botón deshabilitado sin client_id

El botón "Probar conexión" queda deshabilitado si no hay client_id configurado. Completá el Client ID (Paso 3 de la configuración) para habilitarlo.

Monitoreo periódico automático

Quralo verifica la integración automáticamente cada minuto, de forma continua y sin requerir ninguna acción de tu parte.

Para no molestar a un sistema caído con chequeos constantes, el monitoreo aplica backoff: tras N fallos consecutivos, espacia los chequeos.

• Intervalo base por defecto: 5 minutos.
• Fórmula: intervalo base × N, donde N es la cantidad de fallos consecutivos.
• Tope de 4 pasos → cooldown máximo de 20 minutos.
• Al recuperarse, vuelve a chequear cada minuto.

Fallos consecutivos	Intervalo de chequeo
0 (estable)	1 minuto
1	5 minutos
2	10 minutos
3	15 minutos
4+	20 minutos (cooldown máximo)

Los emails no son por cada fallo

El monitoreo no envía emails en cada fallo (evita spam). Solo notifica en transiciones de estado. Ver abajo.

Emails de notificación

Quralo envía emails de notificación solo en transiciones de estado:

• active → error: email de caída.
• error → active: email de restauración.

Reglas importantes:

• Si ya está en error, no se reenvía el email de caída — solo se manda cuando el estado cambia (de active a error).
• La verificación manual ("Probar conexión") también dispara la notificación si produce una transición. Es la vía rápida para probar las notificaciones.
• Requiere que esté configurado el Email de notificación.
• Remitente: Quralo no-reply@quralo.com.

Comportamiento esperado al probar caída/recuperación

1. Con la integración active, si el sistema externo se cae → el monitoreo (o un "Probar conexión" manual) detecta la caída en ≤ 1 minuto y envía el email de caída.
2. Si el sistema externo vuelve → el monitoreo detecta la restauración (puede tardar hasta el cooldown del backoff, máx. ~20 min) y envía el email de restauración. Para verificar de inmediato, usá "Probar conexión" manual.
3. Si la integración ya estaba en error y seguís con el servicio caído, no se envía un nuevo email (ya se notificó la transición).

Detalle del check (qué valida)

1. Token: red/TLS, client_id, aceptación de la clave pública, algoritmo, kid, scopes.
2. /metadata autenticado: valida que el token sea aceptado contra la base FHIR correcta, que fhirVersion == 4.0.1, y que estén presentes los recursos requeridos (si se configuran).

IPs de salida de Quralo

En la vista, bajo "Verificación y monitoreo", se muestra un bloque "IPs de salida de Quralo" con la leyenda:

"Agregá estas IPs a la lista de IPs permitidas (allowlist) de tu sistema externo para que Quralo pueda comunicarse."

• La mayoría de los sistemas externos exigirán la allowlist de IP. Si el bloque no aparece en tu vista, contactá a soporte@quralo.com para confirmar su disponibilidad.
• Las IPs son estáticas, por lo que podés agregarlas a la allowlist de forma permanente.
• Agregalas a la lista de IPs permitidas de tu sistema de salud para que el tráfico saliente de Quralo llegue a tu API.

Dónde ver el estado

El estado actual de la integración se muestra en la vista Integraciones → Sistema de salud, con el indicador ● Activa / ● Con errores y la fecha del último check.

Siguiente paso

Si algo falla, consultá la Solución de problemas.