Status da instalação

Verifique se o rastreador Zenovay está funcionando sem precisar acompanhar o globo em tempo real. O endpoint Install Health retorna um retrato estruturado da atividade recente do rastreador, da acessibilidade do seu site, da configuração atual de cookieless e consentimento, além de uma lista acionável de problemas.

Onde encontrá-lo

No painel Zenovay:

1. Abra a página Domínios e clique no seu domínio.
2. Abra Configurações e clique na aba Status da instalação.
3. O relatório se atualiza automaticamente a cada 30 segundos. Use Atualizar para forçar uma nova checagem.

Lendo a resposta

Cada chamada retorna um objeto JSON com os seguintes campos:

Cores de status no painel

Os quatro cartões no topo da aba usam os seguintes limites:

• Verde — eventos recebidos nos últimos 5 minutos.
• Amarelo — eventos recebidos na última hora, mas não nos últimos 5 minutos.
• Vermelho — silencioso por mais de uma hora ou nenhum evento jamais recebido.

Problemas comuns e correções

O array issues enumera os códigos de diagnóstico que o Zenovay pode retornar. Cada item carrega uma severity, um code estável, uma message legível e uma fix_url.

Alertas por e-mail (opt-in por domínio)

Quando o diagnóstico dispara um erro silent_tracker para o seu domínio, o Zenovay envia um e-mail único para o proprietário do site. Quando os eventos voltam, você recebe um único e-mail de "tudo certo". Máximo de um e-mail por incidente — cinco camadas de deduplicação previnem spam:

1. O cron executa a cada 6 horas, não a cada minuto.
2. O próprio limite silent_tracker exige um intervalo de no mínimo 6 horas.
3. Sites com menos de 5 eventos nas últimas 24 horas nunca disparam um alerta (um blog pessoal com uma visita por dia nunca lhe enviará um e-mail).
4. Uma máquina de estados interna dispara apenas em transições (saudável → silencioso ou silencioso → saudável), nunca em execuções de cron consecutivas.
5. A chave de idempotência do log de e-mails é ancorada no carimbo de tempo do primeiro silêncio do incidente — nem um bug na máquina de estados pode enviar dois e-mails silenciosos por incidente.

Domínios de sandbox/desenvolvimento (localhost, *.vercel.app, *.netlify.app, *.pages.dev, *.workers.dev, *.test, *.local) são totalmente excluídos dos alertas.

Ative ou desative os alertas por domínio em Domínio → Configurações → Status da instalação → Alertas por e-mail. Ativo por padrão.

Referência da API

Exemplo de requisição

# A URL NÃO leva dois-pontos no início — substitua ZV_SEU_CODIGO
# pelo seu código real em app.zenovay.com → Domínio → Configurações.
# O JWT Bearer é obrigatório; copie-o de uma sessão logada do painel
# via DevTools → Rede → /api/auth/user.
curl https://api.zenovay.com/api/install-health/ZV_SEU_CODIGO \
-H "Authorization: Bearer $SEU_JWT"

Exemplo de resposta

{
"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": []
}