Documentação

Verifique seu domínio

Configure SPF, DKIM e DMARC para enviar do seu próprio domínio com entregabilidade máxima.

1. Adicione o domínio

Vá em Dashboard → Domínios → Adicionar domínio e informe o FQDN (ex: mail.empresa.com.br).

2. Insira os registros DNS

A CoffeeMail gera automaticamente os registros necessários. Copie-os para o painel do seu provedor DNS (Route53, Cloudflare, Registro.br, etc).

Ownership (TXT) Comprova que você controla o domínio. Use o valor exato retornado em data.records.	bashbash `empresa.com.br. IN TXT "coffeemail-verify=abc123xyz"`
SPF (TXT na raiz) Autoriza os IPs da CoffeeMail a enviar email em seu nome. Modelo recomendado: v=spf1 include:_spf.coffeemail.com.br ~all.	bashbash `empresa.com.br. IN TXT "v=spf1 include:_spf.coffeemail.com.br ~all"`
DKIM (CNAME) Chave RSA 2048 com seletor dedicado (ex: cm._domainkey.empresa.com.br). Assina os cabeçalhos From, To, Subject, Date e Message-Id.	bashbash `cm._domainkey.empresa.com.br. IN CNAME cm.dkim.coffeemail.com.br.`
DMARC (TXT em _dmarc) Define política de falha. Sugerimos começar com p=none para monitorar, evoluir para p=quarantine e depois p=reject.	bashbash `_dmarc.empresa.com.br. IN TXT "v=DMARC1; p=none; rua=mailto:dmarc@empresa.com.br"`

3. Acione a verificação

Volte para o dashboard e clique em Verificar agora. A plataforma consulta os servidores DNS globais e atualiza o status para verified.

verify-domain.ts

const { data } = await coffeemail.domains.verify('dom_123');console.log('SPF:', data.checks.spf.ok);console.log('DKIM:', data.checks.dkim.ok);console.log('DMARC:', data.checks.dmarc.ok);console.log('Ownership:', data.checks.ownership.ok);console.log('Status:', data.status);

4. Monitore a saúde

Use coffeemail.domains.getHealth(id) periodicamente para acompanhar score, presença em blacklists e recomendações.

health.ts

const { data } = await coffeemail.domains.getHealth('dom_123');console.log('Score:', data.score);console.log('Blacklists:', data.blacklistCount);console.log('Recomendações:', data.recommendations);

Comece com p=none no DMARC para monitorar relatórios por 1-2 semanas antes de evoluir para p=quarantine e depois p=reject. Pular etapas pode bloquear emails legítimos.