SendGrid para Mailtrap:
Um Guia de Migração

Este guia cobre os princípios básicos de como migrar do SendGrid para o Mailtrap sem dificuldades: comparações de terminologia, configurações SMTP ou API e outras especificações técnicas necessárias para uma transição simples.

Principais diferenças entre SendGrid e Mailtrap

  1. Dependendo do plano, o Mailtrap armazena os emails nos Registros de Emails durante 30 dias. O conteúdo dos emails e os dados do histórico são armazenados e acessíveis durante 3 a 7 dias, sem taxas adicionais.
  2. Você pode solicitar faturamento anual com o Mailtrap, não apenas planos com cobrança mensal.
  3. O Mailtrap oferece Email Testing. Este é um produto separado para inspecionar HTML/CSS, pontuações de spam, entre outros, bem como para depurar emails em ambientes de staging, desenvolvimento e de QA antes de enviá-los para os destinatários.

Comparação de terminologia

  • Teammates
  • SendGrid Templates
  • Suppressions
  • Categories
  • Webhooks
  • X-SMTPAPI
  • unique_args

Fluxo geral passo a passo para a migração

  1. Cadastre-se no Mailtrap, adicione seu domínio de envio no menu Sending Domains (Domínios de Envio) e verifique-o. Veja nosso Guia de Introdução para mais detalhes.

  2. Se você usa o serviço SMTP, altere suas configurações conforme necessário.

  3. Se você usa API, confira nossas bibliotecas e a documentação da API.

  4. Exporte sua lista de contatos do SendGrid 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, consulte o 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

    Você pode usar o gem ActionMailer Balancer do Ruby para distribuir proporcionalmente a carga de envio de emails entre dois serviços diferentes (ex.: 70% SendGrid e 30% Mailtrap) para reduzir os riscos do 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.
Aba 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 SendGrid. 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

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
smtp.sendgrid.net

Portas SMTP

PortaFunçãoSuporte MailtrapSuporte SendGrid
587Recomendado para conexão SMTP com criptografia TLS
25Pode ser problemático devido ao bloqueio por alguns provedores de email para evitar abuso
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 APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Bibliotecas da API

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

Linguagem de programaçãoMailtrapSendGrid
Node.jsNode.js SDKNodeJS
NodeMailer (Node.js)NodeMailer SDKNão suportado
PHPPHP SDKPHP
PHP (Laravel + Symphony)PHP SDKNão suportado (apenas um driver comunitário disponível)
RubyRuby SDKRuby
Ruby (ActionMailer)ActionMailer SDKUma biblioteca da comunidade
PythonPython SDKPython
ElixirElixir SDKApenas bibliotecas da comunidade
JavaJava SDKJava

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 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 do ActionMailer permite distribuir proporcionalmente a carga de envio de emails entre dois serviços diferentes, mitigando os riscos de envio.

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.