Estado de la instalación

Verifica que tu rastreador de Zenovay funciona sin tener que vigilar el globo en tiempo real. El endpoint Install Health devuelve una instantánea estructurada de la actividad reciente del rastreador, la accesibilidad de tu sitio, la configuración actual de cookieless y consentimiento, y una lista accionable de incidencias.

Dónde encontrarlo

En el panel de Zenovay:

1. Abre la página Dominios y haz clic en tu dominio.
2. Abre Configuración y haz clic en la pestaña Estado de la instalación.
3. El informe se actualiza automáticamente cada 30 segundos. Usa Actualizar para forzar una nueva comprobación.

Lectura de la respuesta

Cada llamada devuelve un objeto JSON con los siguientes campos:

Colores de estado en el panel

Las cuatro tarjetas en la parte superior de la pestaña usan los siguientes umbrales:

• Verde — eventos recibidos en los últimos 5 minutos.
• Amarillo — eventos recibidos en la última hora pero no en los últimos 5 minutos.
• Rojo — sin actividad durante más de una hora, o sin eventos jamás.

Problemas comunes y soluciones

El array issues enumera los códigos de diagnóstico que Zenovay puede devolver. Cada entrada lleva una severity, un code estable, un message legible y una fix_url.

Alertas por correo electrónico (opt-in por dominio)

Cuando el diagnóstico activa un error silent_tracker para tu dominio, Zenovay envía un correo único al propietario del sitio. Cuando los eventos vuelven, recibes un correo único de "todo en orden". Máximo un correo por incidencia — cinco capas de deduplicación previenen el spam:

1. El cron se ejecuta cada 6 horas, no cada minuto.
2. El umbral silent_tracker en sí requiere un intervalo de al menos 6 horas.
3. Los sitios con menos de 5 eventos en las últimas 24 horas nunca disparan una alerta (un blog personal con una visita al día nunca te enviará un correo).
4. Una máquina de estados interna se activa solo en transiciones (sano → silencioso o silencioso → sano), nunca en ejecuciones de cron consecutivas.
5. La clave de idempotencia del registro de correos está anclada a la marca de tiempo del primer silencio de la incidencia — ni siquiera un error en la máquina de estados puede enviar dos correos silenciosos por incidencia.

Los dominios sandbox/desarrollo (localhost, *.vercel.app, *.netlify.app, *.pages.dev, *.workers.dev, *.test, *.local) están totalmente excluidos de las alertas.

Activa o desactiva las alertas por dominio en Dominio → Configuración → Estado de la instalación → Alertas por correo. Activado por defecto.

Referencia de la API

Ejemplo de petición

# La URL NO lleva dos puntos al inicio — reemplaza ZV_TU_CODIGO
# por tu código real desde app.zenovay.com → Dominio → Configuración.
# El JWT Bearer es obligatorio; cópialo desde una sesión iniciada del
# panel vía DevTools → Red → /api/auth/user.
curl https://api.zenovay.com/api/install-health/ZV_TU_CODIGO \
-H "Authorization: Bearer $TU_JWT"

Ejemplo de respuesta

{
"last_event_seen_at": "2026-05-02T21:15:42.110Z",
"minutes_since_last_event": 0,
"last_event_count_5m": 12,
"last_event_count_24h": 1843,
"script_reachable": true,
"script_version": "v2.0.1",
"csp_blocking_suspected": false,
"cookieless_enabled": true,
"consent_recording_active": false,
"last_5_event_types": ["pageview", "click", "scroll", "form_submit", "outbound_click"],
"issues": []
}