Adicionar um domínio de envio

Este guia mostra como adicionar um domínio de envio, publicar os registros DNS dele e verificá-lo. São alguns minutos de trabalho, mais o tempo que o seu provedor de DNS levar para publicar os registros.

Antes de começar

• Você precisa ter acesso às configurações de DNS do domínio, ou conhecer alguém que tenha. Você pode enviar os registros por e-mail para essa pessoa.
• Decida de qual domínio você vai enviar. Usar um subdomínio como mail.acme.com mantém a sua reputação de envio separada da do domínio raiz. Consulte Domínio raiz ou subdomínio?
• Confira se o seu plano comporta mais um domínio. Consulte Limites de domínios.
• Para a API, use uma chave de API Full Access. Chaves só de envio não podem gerenciar domínios.

Regras para o nome do domínio

• Digite só o domínio: acme.com ou mail.acme.com. Não inclua http://, https:// nem o prefixo www..
• Use letras, dígitos, hifens e pontos, com um domínio de primeiro nível de pelo menos duas letras. O Emailit armazena o nome em minúsculas.
• São permitidos subdomínios em qualquer nível, por exemplo eu.mail.acme.com. Cada um é um domínio separado, com os seus próprios registros.
• Um nome só pode ser adicionado uma vez por workspace. Adicioná-lo de novo retorna 409 Domain with this name already exists.

Adicionar o domínio

curl https://api.emailit.com/v2/domains \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'

{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}

Não há uma opção separada para e-mails de saída ou de entrada. Um domínio verificado pode enviar e recebe e-mails assim que o registro MX de recebimento dele é publicado. A API aceita os indicadores outgoing e incoming por compatibilidade, mas eles não mudam o comportamento do domínio.

Publicar os registros DNS

Adicione os registros na empresa que hospeda o DNS do seu domínio. Muitas vezes é o seu registrador (GoDaddy, Namecheap) ou um serviço de DNS (Cloudflare, Amazon Route 53).

A maioria dos provedores de DNS quer no campo de host só a parte antes do seu domínio (emailit, e não emailit.acme.com). Registros DNS traz os valores exatos, dicas para cada provedor e erros comuns.

Se o seu domínio usa o DNS do Cloudflare, a página do domínio oferece Set up with Cloudflare, que cria os registros para você. Consulte Configurar o DNS com o Cloudflare.

Enviar os registros para outra pessoa

Se outra pessoa gerencia o seu DNS, envie os registros para ela por e-mail pelo painel.

1. Abra o domínio. Em Email API›Domains, selecione o domínio.

2. Selecione Send to email. A opção fica no canto superior direito do card DNS Setup.

3. Digite o endereço da pessoa. Em Recipient Email, digite o endereço do seu desenvolvedor ou administrador de TI e selecione Send Instructions.

A pessoa recebe um e-mail do Emailit com todos os registros e os valores deles. Peça para ela avisar quando os registros estiverem publicados, para você executar a verificação.

Verificar o DNS e o domínio

curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

O domínio é verificado quando SPF, DKIM e return path mostram OK. DMARC, rastreamento e recebimento são opcionais e não afetam a verificação.

Confirmar que funcionou

• O domínio aparece como Verified em Email API›Domains, e as colunas SPF, DKIM e Return Path mostram OK.
• Envie uma mensagem de teste de um endereço do domínio. Na página Emails, selecione Compose, ou chame Enviar um e-mail.

Se o domínio aparecer como Pending verification, ele está aguardando uma análise manual. Isso vale para domínios no Pay as you go registrados há menos de 30 dias. Consulte Verificação de domínio.

Solução de problemas

Verificação de domínio trata de mais casos.

Veja também