# Agente de entregabilidade

> O agente de entregabilidade do Couryo confere SPF, DKIM, DMARC e return path ao vivo, listas de bloqueio do domínio, devoluções e reclamações por provedor, e manda o resumo semanal "Saúde do seu e-mail".

Fonte: https://couryo.com/docs/deliverability

O agente de entregabilidade acompanha cada domínio do projeto e explica em linguagem simples o que está bom, o que está em risco e como corrigir. Nesta versão ele **só lê e avisa**: não muda DNS, não pausa nada e não mexe na sua lista.

## O que ele confere

| Item | Como |
|---|---|
| **SPF, DKIM, DMARC e return path** | consulta ao vivo no DNS: os dois seletores DKIM (`couryo1` e `couryo2`), o endereço de devolução, o DMARC (política e registros duplicados) e o SPF do domínio principal (dois registros SPF ou `+all` viram alerta) |
| **Listas de bloqueio do domínio** | Spamhaus DBL e SURBL, por DNS. Quando a lista recusa a consulta, o resultado aparece como "sem resposta", nunca como "limpo" |
| **Devoluções e reclamações** | dos últimos 30 dias, no total e por provedor de destino (Gmail, Microsoft, Yahoo, UOL, BOL, Terra, Locaweb e outros), com alerta quando um provedor destoa |
| **Reputação** | as recomendações de reputação do motor de envio para o seu domínio (DKIM, DMARC, SPF, devoluções, reclamações), traduzidas |
| **Próximo passo do DMARC** | depois de 30 dias limpos, sugere subir de `p=none` para `p=quarantine`, e depois para `p=reject`, com o registro pronto para copiar |

"30 dias limpos" quer dizer: domínio verificado e com a política atual há 30 dias ou mais, DKIM e return path certos, fora das listas, devoluções até 2% e reclamações até 0,1% nos últimos 30 dias, e a conta sem pausa nesse período. Antes de subir o DMARC, confira se todo serviço que envia pelo seu domínio (e-mail corporativo, cobrança, CRM) assina com DKIM do próprio domínio: a política vale para todos eles.

O resultado de cada domínio é **Tudo certo**, **Pede atenção** ou **Problema sério**, com os pontos encontrados, do mais grave para o mais leve, e como corrigir cada um.

## Onde ver

- **Painel:** a tela **Entregabilidade** mostra o diagnóstico de todos os domínios do projeto, com o botão **Conferir agora**; o **Início** tem o cartão "Saúde do e-mail".
- **API:** `GET /v1/domains/{id}/health` (escopo `read`).
- **MCP:** a ferramenta `domain_health` devolve o mesmo diagnóstico para o seu agente de IA. Veja [MCP e agentes](https://couryo.com/docs/mcp.md).
- **E-mail:** toda segunda de manhã (horário de Brasília), o resumo **"Saúde do seu e-mail"** com a situação de cada domínio e os pontos principais. Para parar, desligue **Saúde semanal** em **Configurações > Notificações**.

O diagnóstico fica guardado por 15 minutos; `?refresh=1` (ou **Conferir agora**) roda tudo de novo.

```bash title="cURL"
curl "https://api.couryo.com/v1/domains/dom_7h2kq9w4x1abcdef/health?refresh=1" \
  -H "Authorization: Bearer $COURYO_API_KEY"
```

```json title="Resposta (resumida)"
{
  "domain": "exemplo.com.br",
  "status": "good",
  "summary": "Tudo certo com exemplo.com.br: autenticação completa, fora das listas de bloqueio e devoluções em 0,6% nos últimos 30 dias.",
  "authentication": {
    "spf": { "status": "ok", "detail": "..." },
    "dkim": { "status": "ok", "selectors": [{ "selector": "couryo1", "status": "ok" }, { "selector": "couryo2", "status": "ok" }], "detail": "..." },
    "dmarc": { "status": "warning", "policy": "none", "detail": "..." },
    "return_path": { "status": "ok", "detail": "..." }
  },
  "blocklists": [
    { "list": "spamhaus_dbl", "name": "Spamhaus DBL", "status": "clean", "detail": "Fora da lista." },
    { "list": "surbl", "name": "SURBL", "status": "clean", "detail": "Fora da lista." }
  ],
  "delivery": { "window_days": 30, "sent": 1840, "bounced": 11, "complained": 0, "bounce_rate": 0.006, "complaint_rate": 0, "by_provider": [] },
  "reputation": [],
  "dmarc_suggestion": {
    "current": "none",
    "next": "quarantine",
    "record": "v=DMARC1; p=quarantine; rua=mailto:dmarc@couryo.com; adkim=r; aspf=r",
    "clean_days": 34,
    "message": "..."
  },
  "findings": []
}
```

## O que ainda não faz

- Agir sozinho (subir o DMARC, pausar uma campanha, suprimir uma lista): vem depois, sempre com a sua permissão.
- Ler os relatórios agregados do DMARC e dados do Google Postmaster e do Microsoft SNDS: em breve. Hoje as taxas vêm dos envios feitos pelo Couryo.
- Avisos por Slack ou WhatsApp: em breve; hoje o resumo chega por e-mail.