Enviar e-mail através da sua própria conta do Mailgun

Você precisará de uma conta no Mailgun e de acesso ao DNS do seu domínio.

Documentação própria do Mailgun: Adicionar e verificar um domínio · Chaves de API · Cadastre-se

1. Adicione seu domínio de envio ao Mailgun

No painel do Mailgun, vá em Send → Domains → Add New Domain (Enviar → Domínios → Adicionar Novo Domínio) e digite um subdomínio, por exemplo, mail.seudominio.com.

⚠️ A própria orientação do Mailgun é usar um subdomínio, e isso importa mais aqui do que com alguns provedores: o Mailgun define seus próprios registros SPF e DKIM em qualquer coisa que você fornecer a ele, e apontá-lo para o seu domínio raiz significa que esses registros ficarão junto daqueles de que suas caixas de correio profissionais dependem.

Escolha a região correspondente a onde você deseja que seus dados fiquem — US ou EU. Anote-a; você precisará dela na etapa 4, e esse é o erro mais comum de todos.

2. Publique os registros DNS fornecidos pelo Mailgun

O Mailgun mostra uma lista. Adicione cada um deles no seu provedor de DNS.

| Tipo | Host | Finalidade | | --- | --- | --- | | TXT | mail.seudominio.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.seudominio.com | Chave pública DKIM | | CNAME | email.mail.seudominio.com | Rastreamento e tratamento de devoluções | | MX | mail.seudominio.com | Recebimento de devoluções (os dois hosts MX do Mailgun) |

⛔ Se o seu subdomínio de envio já tiver um registro SPF, edite-o — não adicione um segundo. Um domínio com dois registros TXT de SPF falha totalmente no SPF, o que é pior do que não ter nenhum.

Em seguida, clique em Verify DNS Settings (Verificar configurações de DNS) no Mailgun. Pode levar até uma hora para ficar verde.

⭐ Adicione os registros MX, mesmo que você esteja apenas enviando. É por meio deles que o Mailgun coleta devoluções. Sem eles, um endereço inválido é devolvido para lugar nenhum, o Mailgun não pode suprimi-lo e você continua pagando para enviar a um endereço que nunca receberá nada.

3. Obtenha sua chave de API

Send → Sending → Domain settings → API keys (Enviar → Envio → Configurações de domínio → Chaves de API) ou a página API Keys da sua conta.

Use uma chave de envio restrita a este domínio se o seu plano oferecer uma, em vez da chave de API privada da sua conta. Uma chave de envio só pode enviar; a chave privada pode ler seus logs e alterar sua conta. Não há motivo para guardarmos a segunda.

4. Conecte-o no Zinn®

Abra Envio de e-mail no seu painel e preencha:

Provedor — Mailgun
Enviar a partir deste domínio — mail.seudominio.com (um domínio, não um endereço)
Domínio de envio do Mailgun — o mesmo domínio que você adicionou no Mailgun
Região — us ou eu, correspondente à etapa 1
Chave de API do Mailgun — a chave da etapa 3

⛔⛔ Acerte a região. As contas do Mailgun hospedadas na UE são atendidas a partir de um host de API completamente diferente. Enviar a chave de uma conta da UE para o host dos EUA retorna "401 Unauthorized" — o que parece exatamente com uma chave incorreta. Se a sua chave estiver definitivamente correta e você estiver recebendo o erro 401, quase sempre é por isso.

5. Envie o teste e digite o código

Clique em Send test message (Enviar mensagem de teste), usando uma caixa de entrada em um domínio diferente — um endereço do Gmail é ideal. Leia o código nessa caixa de entrada e digite-o. Seu e-mail é alternado imediatamente.

Quando não funcionar

401 Unauthorized — região incorreta (veja acima) ou você colou uma chave de uma conta diferente do Mailgun. Regenere a chave em vez de redigitá-la; o prefixo key- é fácil de perder.

A mensagem de teste nunca chega — verifique a página Logs do Mailgun. Se o Mailgun não tiver nenhum registro dela, a credencial ou o nome do domínio estão incorretos. Se o Mailgun a aceitou e ela falhou depois, o motivo estará lá em palavras claras, e quase sempre é o DNS.

"Domain not found" — o campo Domínio de envio do Mailgun deve ser exatamente o domínio listado pelo Mailgun, incluindo o subdomínio. seudominio.com e mail.seudominio.com são dois domínios diferentes para o Mailgun.

Funcionou e depois parou — verifique se o seu teste gratuito terminou. As contas de teste do Mailgun só podem enviar para destinatários autorizados, então a mensagem de teste para o seu próprio endereço continua funcionando enquanto todas as mensagens para os seus clientes param silenciosamente.