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
- 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.
- Você pode solicitar faturamento anual com o Mailtrap, não apenas planos com cobrança mensal.
- 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
- User Management
- Templates
- Suppressions
- Email Categories
- Webhooks
- Headers
- X-MT-Custom-Variables
- Teammates
- SendGrid Templates
- Suppressions
- Categories
- Webhooks
- X-SMTPAPI
- unique_args
Fluxo geral passo a passo para a migração
-
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.
-
Se você usa o serviço SMTP, altere suas configurações conforme necessário.
-
Se você usa API, confira nossas bibliotecas e a documentação da API.
-
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.
-
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.
-
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.
- 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
Porta | Função | Suporte Mailtrap | Suporte SendGrid |
587 | Recomendado para conexão SMTP com criptografia TLS | ||
25 | Pode ser problemático devido ao bloqueio por alguns provedores de email para evitar abuso | ||
2525 | Para 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.
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.
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 API | Mailtrap | SendGrid |
Email sending | Send email | |
User management | User management | Teammates |
Email Testing | Email Testing API |
Bibliotecas da API
No momento, nove bibliotecas estão disponíveis no Mailtrap.
Linguagem de programação | Mailtrap | SendGrid |
Node.js | Node.js SDK | NodeJS |
NodeMailer (Node.js) | NodeMailer SDK | Não suportado |
PHP | PHP SDK | PHP |
PHP (Laravel + Symphony) | PHP SDK | Não suportado (apenas um driver comunitário disponível) |
Ruby | Ruby SDK | Ruby |
Ruby (ActionMailer) | ActionMailer SDK | Uma biblioteca da comunidade |
Python | Python SDK | Python |
Elixir | Elixir SDK | Apenas bibliotecas da comunidade |
Java | Java SDK | Java |
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.
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.