Mailchimp Transactional Email Para Mailtrap:
Um Guia de Migração

Este guia destaca como migrar do Mailchimp Transactional Email para o Mailtrap de forma simples, incluindo principais diferenças, comparações de terminologia, configurações SMTP e API, e outras especificações técnicas necessárias para a mudança.

Key Differences Between Mailchimp and Mailtrap

  1. O Mailtrap é um produto independente. Já o Mailchimp Transactional Email é um complemento disponível apenas nos planos Standard ou Premium do Mailchimp.
  2. O Mailchimp oferece uma demo para testar o serviço de emails transacionais, que não se renova após o limite de 500 envios. O Mailtrap possui um plano gratuito para sempre, com 1000 emails por mês e limites que se renovam mensalmente. No Mailchimp Transactional Email, só é possível enviar para endereços através seu domínio verificado.
  3. O Mailtrap oferece Bulk Stream (dentro do mesmo plano), permitindo enviar emails para muitos destinatários ao mesmo tempo (newsletters, atualizações de produto, promoções, etc.).
  4. O Mailtrap suporta e requer a validação automática do DMARC (junto com SPF e DKIM).
  5. As APIs do Mailtrap aceitam e retornam apenas JSON. Elas não retornam respostas em formatos XML ou YAML.
  6. O Mailtrap oferece Email Testing. É um ambiente isolado para inspecionar HTML/CSS, pontuações de spam, entre outros, e para depurar emails em ambientes de staging, desenvolvimento e QA antes de enviá-los aos destinatários.
  7. O Mailtrap não permite gerar automaticamente conteúdo HTML a partir de partes de email em texto ou vice-versa. O tipo de conteúdo deve ser especificado no momento do envio do email ou da criação do template.

Comparação de terminologia

  • Users
  • Templates
  • Rejection Blacklist
  • Tags
  • Webhooks
  • Headers
  • X-MC-Metadata

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 aa bibliotecas e a documentação da API do Mailtrap.

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

    Precisa de ajuda?

    Entre em contato com nosso suporte e nossos especialistas técnicos irão ajudá-lo com isso.

  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

    Use o gem Ruby ActionMailer Balancer para distribuir proporcionalmente a carga de envio de emails entre dois serviços de envio diferentes (por exemplo, 70% Mailchimp e 30% Mailtrap), de modo a mitigar os riscos de envio.

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

  • Uma vez que seu domínio seja verificado usando os registros DNS fornecidos, ele passará por uma verificação de conformidade automática. Este processo normalmente leva desde entre alguns minutos a várias horas. Você só poderá enviar emails após a verificação de conformidade ser totalmente concluída e quando o status “verificado” aparecer ao lado do seu domínio.
Separador de verificação de domínio - domínio verificado
  • Defina as opções de cancelamento de assinatura com o Mailtrap e importe suas listas de supressão do Mailchimp (as CSV). Não se esqueça de importar sua lista de emails e modelos 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

Mailchimp Transactional Email

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
smtp.mandrillapp.com

Portas SMTP

PortaFunçãoSuporte do MailtrapSuporte do Mailchimp
587Recomendado para conexão SMTP com criptografia TLS
25Pode haver problemas devido a bloqueios por parte de alguns provedores de email, como forma de evitar abusos
2525Para conexões não criptografadas/TLS

Configuração SMTP

Vá para o menu Sending Domains e clique no domínio verificado de onde você deseja enviar emails. Em seguida, vá até a guia Integrations (Integrações) e clique em Integrate (Integrar) nas das aba Transactional (Transacional) ou Bulk Stream (Fluxo em Massa), 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 APIMailtrapMailchimp Transactional Email
Email sendingSend emailMessages
User managementUser managementUsers
Email TestingEmail Testing API

Bibliotecas da API

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

Linguagem de programaçãoMailtrapMailchimp Transactional Email
Node.jsNode.js SDKNodeJS
NodeMailer (Node.js)NodeMailer SDKNão suportado
PHPPHP SDKPHP
PHP (Laravel + Symphony)PHP SDKNão suportado
RubyRuby SDKRuby
Ruby (ActionMailer)ActionMailer SDKNão suportado
PythonPython SDKPython
ElixirElixir SDKNão suportado
JavaJava SDKNão suportado

Autenticação da API

Usamos autenticação Bearer. Passe o token da 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 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.