Mailgun para Mailtrap:
Um Guia de Migração

Este guia aborda os princípios fundamentais para migrar do Mailgun para o Mailtrap sem complicações: comparações de terminologia, configurações de SMTP ou API e outras especificações técnicas necessárias para uma transição tranquila.

Diferenças principais entre Mailgun e Mailtrap

  1. O Mailtrap oferece planos mensais recorrentes com a opção de solicitar planos mensais ou anuais. Ao contrário do Mailgun, o Mailtrap não oferece um plano pay-as-you-go (pré-pagamento), mas temos um plano de 1000 emails gratuitos para sempre, para testar e avaliar nosso serviço.
  2. O Mailtrap oferece Email Testing. Este é um sandbox para inspecionar HTML/CSS, pontuações de spam, entre outros, bem como para depurar emails em ambientes de staging, desenvolvimento e QA antes de enviá-los para os destinatários. (Nota: o Mailgun recomenda o Email on Acid da Sinch para testes)
  3. O Mailgun limita as contas que não adicionam um cartão de crédito. Isso não acontece no Mailtrap.
  4. O Mailtrap possui fluxos separados (endpoints de servidor) para emails em massa e emails acionados por usuário.
  5. O Mailtrap possui construtores de emails HTML e arrastar-e-soltar, enquanto o Mailgun suporta apenas templates HTML e recomenda o uso do Mailjet da Sinch para construção de templates e editor de arrastar-e-soltar.

Mailtrap e Mailgun – Semelhanças

  1. Suporte para envio via SMTP ou API REST.
  2. Você pode usar registros return-path e DKIM para verificar um domínio.
  3. Você pode adicionar um arquivo .csv para importar endereços de email suprimidos e listas de emails.
  4. O Mailgun e o Mailtrap permitem que você adicione opções de cancelamento de inscrição aos emails sem precisar de código.
  5. Você pode agendar campanhas de email com ambos os serviços, mas o Mailgun permite isso apenas por meio da API de email.
  6. Ambos os serviços suportam 2FA.

Comparação de terminologia

  • Multi User Access
  • Mailgun Templates
  • Suppressions
  • Tags 
  • Webhooks
  • X-headers
  • X-Mailgun-Variables 

Fluxo geral passo a passo para a migração

  1. Após se inscrever no Mailtrap, selecione o menu Sending Domains. Adicione seu domínio e prossiga para verificá-lo. Para mais detalhes, consulte nosso Guia de Primeiros Passos.

  2. Se você escolher o serviço SMTP, altere as configurações de envio conforme as credenciais fornecidas pelo Mailtrap. Veja mais informações na secção SMTP abaixo.

  3. Caso escolha a integração via API, consulte a documentação da API e as bibliotecas do Mailtrap.

  4. Exporte sua lista de contatos do Mailgun como CSV* e importe-os para o Mailtrap. Confira nosso guia passo-a-passo.

    Precisa de ajuda?

    Contacte o nosso suporte e os nossos técnicos irão ajudar.

  5. Você também pode importar seus templates de email como HTML ou criar novos usando um criador de templates HTML ou de arrastar-e-soltar. Para mais informações, acesse nosso Guia de Templates de Email.

  6. Se você planeja enviar mais de 200 mil emails por mês, entrar em contato com o suporte do Mailtrap é altamente recomendado. Eles o ajudarão no processo, atribuirão um IP dedicado e verificarão se tudo está configurado corretamente.

    Dica Mailtrap

    Pode usar o Ruby gem ActionMailer Balancer para distribuir a carga de emails de forma proporcional entre dois serviços de envio diferentes (ex: 70% no Mailgun e 30% no Mailtrap) para mitigar os riscos de envio.

*No momento da redação, só era possível exportar listas de contatos via API do Mailgun (com chamada de API “GET”), com um limite de 100 registros.

Primeiros passos

Para começar a enviar emails com o Mailtrap, basta criar uma conta e verificar seu domínio. A configuração e verificação do domínio são feitas no menu Sending Domains. Leia este artigo para saber mais sobre esse processo.

Verificação de domínio

  • Após seu domínio ser verificado usando os registros DNS fornecidos, ele passa por uma verificação de conformidade automática. Esse processo normalmente dura desde alguns minutos a várias horas. Você só pode enviar emails após a verificação de conformidade ser totalmente aprovada e o status “verificado” aparecer ao lado do seu domínio.
Separador de verificação de domínio - domínio verificado
  • Configure as opções de cancelamento no Mailtrap e importe suas listas de supressão do Mailgun (em formato CSV). Além disso, lembre-se de importar sua lista de emails e templates em HTML para o Mailtrap.
  • Opcionalmente, crie webhooks para receber informações sobre rejeições, reclamações de spam, aberturas, cliques e outros eventos.
  • Ative o rastreamento de aberturas e cliques para entender como os clientes interagem com seus emails.

Envio com SMTP do Mailtrap

Endpoints SMTP

Servidor Mailgun (UE)Servidor Mailgun (EUA)
live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		smtp.eu.mailgun.orgsmtp.mailgun.org

Portas SMTP

PortaFunção
587O retransmissor SMTP recomendado com TLS.
25Alto tráfego, bloqueado por alguns provedores de email devido a abuso.
2525Porta alternativa, caso encontre problemas com outras portas.

Configuração SMTP

Vá para o menu Sending Domains e clique no domínio verificado de onde você deseja enviar os emails. Vá para a aba Integration e clique em Integrate sob Transactional ou Bulk Stream, dependendo do tipo de emails que deseja enviar.

Separador de seleção de Integration dos Sending Domains do Mailtrap

Copie e cole as credenciais (para o stream que você escolheu) no seu aplicativo ou projeto, e você estará pronto para começar a enviar emails. Leia mais sobre a integração SMTP aqui.

Integração SMTP do Fluxo de envio em massa do Mailtrap

Nota: Ativar TLS é obrigatório, conforme mencionado nas credenciais.

Envio com a API do Mailtrap

Tokens da API do Mailtrap

O Mailtrap cria automaticamente um token quando você adiciona um domínio. Por padrão, o token tem permissão de acesso de Administrador de Domínio. Você pode editar as permissões do token no menu API Tokens (Tokens da API) em Settings (Configurações).

Saiba mais sobre como gerenciar tokens da API no nosso guia.

Mapeamento da API

Tipo de APIMailtrapMailgun
The BasicsGeneralIntroduction
SendingSend emailMessages
Email TestingEmail Testing API

Bibliotecas da API

No momento, nove bibliotecas estão disponíveis no Mailtrap.

Linguagem de programaçãoMailtrapMailgun
Node.jsNode.js SDKMailgunJS
NodeMailer (Node.js)NodeMailer SDKNão suportado
PHPPHP SDKMailgunPHP
PHP (Laravel + Symphony)PHP SDKNão suportado
RubyRuby SDKGem Ruby do Mailgun
Ruby (ActionMailer)ActionMailer SDKNão suportado
PythonPython SDKNão suportado
ElixirElixir SDKNão suportado
JavaJava SDKMailgun Java

Autenticação da API

Utilizamos autenticação Bearer. Insira o token de API no código sob o cabeçalho Authorization.

Permissões/Gerenciamento de usuários

Se você estiver no plano Business ou superior, poderá adicionar usuários à sua conta e gerenciar suas permissões. Para isso, clique no menu User Management (Gerenciamento de Usuários) em Settings, depois nos três pontos (menu de mais opções) à direita. Você também pode gerenciar usuários e permissões com API.

Menu User Management do Mailtrap

Com base nas permissões que os usuários recebem, eles podem visualizar, acessar e/ou modificar funcionalidades específicas de um aplicativo. Um usuário precisa de permissões de administrador para ser autenticado e enviar emails via API.

Além disso, o Mailtrap permite que você ative ou desative a autenticação de dois fatores (2FA) do aplicativo, para todos ou alguns usuários dentro da sua conta, tendo a opção de forçar 2FA para todos os usuários. Consulte nosso guia de 2FA para mais detalhes.

Se você deseja aprender mais sobre como gerenciar as permissões dos usuários, clique neste link ◀️.

ActionMailer Balancer para uma migração tranquila

Para aplicações Ruby on Rails, o Mailtrap oferece o ActionMailer Balancer, que facilita a migração.

A extensão ActionMailer permite a distribuição proporcional da carga de envio de emails entre dois serviços diferentes e mitiga os riscos de envio.

Após instalar o Balancer e fazer algumas configurações simples, o método de envio do ActionMailer será estendido.

Para mais informações detalhadas sobre o boilerplate e o uso no desenvolvimento, leia a página do Mailtrap ActionMailer Balancer no Github.