Configurando um domínio de envio do Mailtrap

Visão geral

Você precisa adicionar e verificar um domínio que você controla antes de enviar e-mails reais. O Mailtrap mostra todos os registros DNS necessários para esse domínio na interface do usuário: adicione o conjunto completo conforme fornecido (não escolha apenas alguns). Após a verificação do DNS, complete a etapa de conformidade, se solicitada.

Subdomínio vs. raiz: adicione o nome de host exato que você usará no endereço do remetente. Se você enviar de notifications.mycompany.com, adicione esse subdomínio como o domínio de envio — não apenas mycompany.com, a menos que você realmente envie do domínio raiz.

Para guias passo a passo em hosts comuns, abra o guia correspondente em Configuração de domínio de envio (Cloudflare, Route 53, etc.) e siga-o junto com os valores da interface do usuário em tempo real.

Habilidades relacionadas: mailtrap-sending-emails (depois que o domínio estiver pronto).

Quando usar

• Configuração de novos Domínios de Envio, verificação pendente ou dúvidas sobre conformidade
• DNS em Cloudflare, AWS, Google, Namecheap, GoDaddy, DigitalOcean, etc.

Quando não usar

• Testes apenas em sandbox sem um domínio personalizado (veja mailtrap-testing-with-sandbox)

Autorização

As chamadas da API de Domínios de Envio abaixo exigem Authorization: Bearer $MAILTRAP_API_TOKEN e um $MAILTRAP_ACCOUNT_ID no caminho. Resolva $MAILTRAP_ACCOUNT_ID de GET https://mailtrap.io/api/accounts e armazene tokens em variáveis de ambiente ou em um gerenciador de segredos.

Automatizando a configuração (provedores de API e DNS)

Prefira este caminho ao criar scripts ou automação assistida por IA:

1. Registros e status de DNS via API — Use a API de Domínios de Envio:

• GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains — lista domínios
• GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains/{sending_domain_id} — retorna dns_records (cada um com type, name, value e status de verificação) e dns_verified. Consulte após publicar o DNS.

2. Criar domínio via API —

• POST https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains com domain_name quando seu fluxo provisionar domínios programaticamente.

3. Publicar DNS programaticamente —

• Crie os registros retornados no seu host DNS usando a API deles (por exemplo, API do Cloudflare, AWS Route 53, Google Cloud DNS) ou IaC. Alinhe os nomes e valores dos registros exatamente com a resposta da API.

Fallback humano: Domínios de Envio > Adicionar domínio > copie os valores para a interface do usuário do registrador > Verificar quando a automação da API não estiver disponível.

Fluxo de trabalho (resumo)

1. Domínios de Envio > Adicionar domínio e insira o nome do domínio.
2. Obtenha os registros necessários da interface do usuário ou da API de Domínios de Envio; crie todos os registros listados no seu host DNS exatamente como mostrado (nomes, tipos, valores).
3. Aguarde a propagação do DNS. Se a verificação permanecer pendente, use dig, nslookup ou uma consulta DNS online para confirmar se cada registro está visível publicamente antes de clicar em Verificar novamente.
4. Conclua o fluxo de conformidade quando solicitado.

Demonstração do produto: Configuração de domínio de envio.

Guias de provedores de DNS (documentação)

O Mailtrap publica guias de cliques para provedores comuns. Abra a página que corresponde ao host DNS do usuário e siga-a junto com os registros da interface do usuário em tempo real:

• Cloudflare
• AWS Route 53
• Google Cloud DNS
• Squarespace (inclui notas de transição do antigo Google Domains, quando aplicável)
• GoDaddy
• Namecheap
• DigitalOcean

Se o provedor do usuário não estiver listado, a mesma regra se aplica: copie todos os registros do Mailtrap para a zona DNS que atende ao domínio do remetente.

Observação importante sobre DNS (DNS com proxy)

…