Pular para o conteúdo
couryo

Guia do desenvolvedorEnvio

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".

Ver em Markdown

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.
  • 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.

cURL
curl "https://api.couryo.com/v1/domains/dom_7h2kq9w4x1abcdef/health?refresh=1" \
  -H "Authorization: Bearer $COURYO_API_KEY"
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.