Verificar domínio

Por que isso é obrigatório

Sem DKIM e SPF, o Gmail e o Outlook não têm como saber que a mensagem saiu de quem diz ter saído, e mandam para o spam ou recusam. A exigência não é nossa, é dos provedores que recebem.

Enquanto o domínio não fecha, dá para testar tudo com os apelidos de teste, que não pedem domínio verificado.

1. Adicionar o domínio

curl -X POST https://api.jetsend.com.br/v1/domains \  -H "Authorization: Bearer $JETSEND_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "dominio": "suaempresa.com.br" }'

A resposta traz o id do domínio e a lista dos registros que você precisa publicar. No painel a mesma lista aparece com botão de copiar em cada valor, que é o caminho mais curto para não errar de letra.

2. Publicar no seu provedor de DNS

São cinco registros obrigatórios e um opcional:

• um TXT na raiz com jetsend-verify=<seu token>, que é a prova de posse. Ele é o único que ninguém além de você consegue publicar, e sem ele a verificação não fecha;
• três CNAME em dkim1._domainkey, dkim2._domainkey e dkim3._domainkey, que apontam para ...dkim.amazonses.com;
• um TXT na raiz, com v=spf1 include:amazonses.com ~all;
• e, opcional, um CNAME em track, só para que o rastreamento de abertura e clique saia no seu domínio em vez do nosso. O envio funciona sem ele.

Se você já tem um TXT de SPF, não crie um segundo. Dois registros SPF no mesmo domínio invalidam os dois, e o resultado é pior do que não ter nenhum. Adicione include:amazonses.com ao que já existe.

Registro.br e afins

Alguns provedores brasileiros pedem o nome do registro sem o domínio no fim, e outros pedem com. Colar dkim1._domainkey.suaempresa.com.br onde o painel espera só dkim1._domainkey cria dkim1._domainkey.suaempresa.com.br.suaempresa.com.br, que nunca resolve. Se o seu não verifica, é o primeiro lugar para olhar.

3. Esperar o verde

curl -X POST https://api.jetsend.com.br/v1/domains/DOMAIN_ID/verify \  -H "Authorization: Bearer $JETSEND_API_KEY"

O painel refaz a consulta sozinho a cada 30 segundos, e agrupa os registros por função para você colar um conjunto de cada vez. A chamada acima força a verificação na hora, para quem está automatizando.

Quando o DNS já propagou, costuma fechar em menos de um minuto. Propagação em si pode levar horas, e isso depende do seu provedor, não de nós.

O veredito é do domínio inteiro, não registro por registro. Enquanto faltar qualquer um dos obrigatórios, o resultado continua “não verificado”: não temos como dizer que o DKIM passou e o SPF não, porque a consulta responde pelo conjunto.

Listar e remover

GET /v1/domains lista os domínios da conta com o status de cada um, e GET /v1/domains/:id traz um só, com os registros. DELETE /v1/domains/:id remove. Remover um domínio faz qualquer envio com remetente dele passar a ser recusado com 422.