Monitoramento de Saúde de Domínios

O Notifica monitora automaticamente a saúde dos registros DNS dos seus domínios de envio. Quando um registro é removido, alterado, ou degradado, o sistema cria alertas automaticamente e pode resolver-los quando o problema é corrigido.

Como Funciona

Verificações Automáticas

O Notifica executa health checks DNS a cada 6 horas para todos os domínios verificados. Cada verificação consulta:

Tipo de Registro	O que é verificado	Impacto se ausente
TXT (verificação)	Token notifica-verification=... presente	Domínio pode perder status de verificado
DKIM	Registro notifica._domainkey.<domain> com chave pública RSA	Emails sem assinatura DKIM — maior chance de spam
SPF	include:spf.usenotifica.com.br no registro SPF	Emails podem falhar SPF check — rejeição por provedores
MX	Registros MX do domínio existem	Não afeta envio, mas indica domínio possivelmente abandonado
DMARC	Registro _dmarc.<domain> configurado	Sem proteção contra spoofing, menor deliverability

Níveis de Status

Cada registro recebe um dos seguintes status:

Status	Significado	Ação necessária
ok	✅ Registro encontrado e válido	Nenhuma
warning	⚠️ Registro encontrado mas com problemas (ex: DMARC com p=none)	Recomendado melhorar
missing	❌ Registro não encontrado	Adicionar registro DNS
error	🔴 Erro ao consultar DNS (timeout, SERVFAIL, etc.)	Verificar provedor DNS

---

Sistema de Alertas

Criação Automática de Alertas

Quando uma verificação detecta degradação em relação ao último check (ex: um registro que existia e agora está missing), um alerta é automaticamente criado.

Cenários que geram alertas:

• Registro DKIM removido ou alterado
• Registro SPF não inclui mais o Notifica
• Token de verificação TXT removido
• Registro DMARC removido
• Erro persistente na resolução DNS

Resolução Automática

Se um alerta ativo é detectado como corrigido na próxima verificação (ex: o registro DKIM foi restaurado), o alerta é automaticamente resolvido com status resolved.

Ciclo de Vida do Alerta

created → resolved     (problema corrigido automaticamente)
        → acknowledged  (reconhecido manualmente pelo usuário)

---

API — Health Check de Domínios

Consultar Saúde de um Domínio

Retorna o resultado do último health check para um domínio específico.

curl https://app.usenotifica.com.br/v1/domains/dom_abc123/health \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta (200 OK):

{
  "data": {
    "domain_id": "dom_abc123",
    "domain": "suaempresa.com.br",
    "last_check_at": "2025-02-03T12:00:00Z",
    "next_check_at": "2025-02-03T18:00:00Z",
    "overall_status": "warning",
    "records": {
      "txt_verification": {
        "status": "ok",
        "value": "notifica-verification=aBcDeFg...",
        "checked_at": "2025-02-03T12:00:00Z"
      },
      "dkim": {
        "status": "ok",
        "value": "v=DKIM1; k=rsa; p=MIIBIjANBg...",
        "checked_at": "2025-02-03T12:00:00Z"
      },
      "spf": {
        "status": "ok",
        "value": "v=spf1 include:spf.usenotifica.com.br include:_spf.google.com ~all",
        "checked_at": "2025-02-03T12:00:00Z"
      },
      "mx": {
        "status": "ok",
        "records": ["10 mail.suaempresa.com.br"],
        "checked_at": "2025-02-03T12:00:00Z"
      },
      "dmarc": {
        "status": "warning",
        "value": "v=DMARC1; p=none; rua=mailto:[email protected]",
        "message": "DMARC policy is 'none'. Consider upgrading to 'quarantine' or 'reject'.",
        "checked_at": "2025-02-03T12:00:00Z"
      }
    }
  }
}

Forçar um Health Check Manual

Dispara uma verificação imediata (fora do ciclo de 6h).

curl -X POST https://app.usenotifica.com.br/v1/domains/dom_abc123/health/check \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta (200 OK):

{
  "data": {
    "domain_id": "dom_abc123",
    "status": "check_started",
    "message": "Health check iniciado. Resultados disponíveis em alguns segundos."
  }
}

aviso

Rate limit: Máximo de 1 check manual por minuto por domínio. Requests excedentes retornam 429 Too Many Requests.

Resposta (429 Too Many Requests):

{
  "error": "rate_limited",
  "message": "Aguarde pelo menos 1 minuto entre verificações manuais.",
  "retry_after": 45
}

Listar Alertas

Retorna todos os alertas ativos e recentes para os domínios do tenant.

curl https://app.usenotifica.com.br/v1/domains/alerts \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta (200 OK):

{
  "data": [
    {
      "id": "alert_001",
      "domain_id": "dom_abc123",
      "domain": "suaempresa.com.br",
      "type": "dkim_missing",
      "severity": "high",
      "message": "Registro DKIM não encontrado para suaempresa.com.br. Emails podem ser marcados como spam.",
      "status": "created",
      "created_at": "2025-02-03T12:00:00Z",
      "resolved_at": null
    },
    {
      "id": "alert_002",
      "domain_id": "dom_def456",
      "domain": "marketing.empresa.com.br",
      "type": "spf_missing",
      "severity": "high",
      "message": "Notifica não está incluído no registro SPF de marketing.empresa.com.br.",
      "status": "resolved",
      "created_at": "2025-02-02T06:00:00Z",
      "resolved_at": "2025-02-02T12:00:00Z"
    }
  ]
}

---

Tipos de Alerta

Tipo	Severidade	Descrição
txt_verification_missing	critical	Token de verificação removido — domínio pode perder verificação
dkim_missing	high	Registro DKIM não encontrado — emails sem assinatura
dkim_invalid	high	Registro DKIM encontrado mas com formato inválido
spf_missing	high	Notifica não incluído no SPF — emails podem ser rejeitados
spf_permerror	medium	Múltiplos registros SPF ou erro de sintaxe
mx_missing	low	Sem registros MX — possível domínio abandonado
dmarc_missing	medium	Sem política DMARC — vulnerável a spoofing
dmarc_weak	low	DMARC com p=none — monitoramento apenas
dns_error	medium	Erro na resolução DNS (timeout, SERVFAIL)

---

Boas Práticas

O que monitorar

1. Sempre priorize alertas critical e high — Afetam diretamente a entrega dos seus emails
2. Configure DMARC com policy quarantine ou reject — Depois de confirmar que SPF e DKIM estão corretos
3. Mantenha SPF com menos de 10 includes — O limite da especificação é 10 lookups DNS

Como responder a alertas

Alerta	Ação recomendada
DKIM missing	Verifique o registro TXT em notifica._domainkey.<domain> no seu DNS
SPF missing	Adicione include:spf.usenotifica.com.br ao seu registro SPF
TXT verification missing	Restaure o registro notifica-verification=... no DNS
DMARC missing	Crie o registro _dmarc.<domain> com v=DMARC1; p=quarantine; rua=mailto:...
DNS error	Verifique se o provedor DNS está funcionando e que o domínio não expirou

Verificação manual vs automática

• Automática (a cada 6h): Suficiente para monitoramento contínuo. Não requer ação.
• Manual: Use após corrigir um problema DNS para verificar imediatamente, sem esperar o próximo ciclo.

dica

Após corrigir um registro DNS, aguarde 5-10 minutos para propagação antes de executar o health check manual. Registros recém-alterados podem não estar visíveis imediatamente para todos os resolvers DNS.

---

Integração com Webhooks

Se você tem webhooks configurados, eventos de domínio são disparados automaticamente:

Evento	Quando
domain.health.degraded	Um ou mais registros mudaram de ok para warning/missing/error
domain.health.recovered	Todos os registros voltaram a ok
domain.alert.created	Novo alerta criado
domain.alert.resolved	Alerta resolvido automaticamente

Veja Webhooks na API Reference para configurar.

---

Referências

• Configuração de Domínio de Envio — Setup inicial completo
• DKIM — Autenticação de Email — Entenda o DKIM customizado
• Dashboard de Domínios — Guia visual do dashboard
• API Reference — Referência completa dos endpoints