SendGrid para Mailtrap:
Um Guia de Migração
Este guia aborda os princípios fundamentais de como migrar de SendGrid para o Mailtrap facilmente: comparações de terminologia, configurações de SMTP ou API e outras especificações técnicas necessárias para que esta troca seja tranquila.
Principais Diferenças entre SendGrid e Mailtrap
- Dependendo do plano, o Mailtrap armazena logs de emails até 30 dias. O conteúdo dos emails e o histórico são armazenados e acessíveis de 3 a 15 dias sem taxas adicionais.
- Pode solicitar um plano/faturação anual para o Mailtrap, além de planos faturados mensalmente.
- O Mailtrap fornece Email Testing. Este é um produto em separado, que permite examinar spam scores e outras informações de HTML/CSS, corrigir bugs de emails, em ambientes de pré-produção, desenvolvimento e QA, antes de os enviar para os destinatários.
- O Mailtrap não possui a opção de agendar o envio de emails.
Comparação de terminologia
- User Management
- Email Templates
- Suppressions
- Categories
- Webhooks
- Headers
- X-MT-Custom-Variables
- Teammates
- SendGrid Templates
- Suppressions
- Email Categories
- Webhooks
- X-SMTPAPI
- unique_args
Fluxo geral de migração passo-a-passo
-
Cadastre-se no Mailtrap, adicione seu domínio de envio em Sending Domains e verifique-o. Consulte o nosso Getting Started Guide para mais detalhes.
-
Se usa o serviço SMTP, altere as suas configurações em conformidade.
-
Se usa API, confira as nossas bibliotecas e documentação de API.
-
Certifique-se de que entende as principais diferenças entre SendGrid e Mailtrap mencionadas acima.
Precisa de ajuda?
Contacte o nosso suporte e os nossos técnicos irão ajudar.
-
Caso queira enviar mais de 200 mil emails por mês, recomendamos que contacte o suporte Mailtrap. E também teremos todo o gosto em ajudar – basta agendar uma chamada com um membro da nossa equipe e certificar-nos-emos de que a sua migração é feita 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 SendGrid e 30% no Mailtrap) para mitigar os riscos de envio.
Começar
Para começar a enviar emails com o Mailtrap, só precisa criar uma conta, registrar-se e verificar o seu domínio. A configuração e verificação do domínio podem ser feitas no menu Sending Domains.
Verificação de domínio
- Depois de criar uma conta e adicionar o seu domínio de envio, levará até dois dias úteis para passar pela verificação de segurança.
- Certifique-se que não faz add-ons, correções ou outras alterações durante o tempo de verificação do domínio, porque pode ser interpretado como um comportamento suspeito.
- Até que o domínio seja verificado, a taxa de transferência é limitada a 50 emails por hora, para evitar o abuso do sistema com atividades de spam. Saiba mais sobre isso em nosso artigo Sending Limits.
- Os limites de envio podem ser suspensos entrando em contacto com a equipe de suporte do Mailtrap. Nesse caso, terá de responder a algumas perguntas para provar a confiabilidade e a autoridade do seu domínio de envio.
Enviar com o Mailtrap SMTP
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 TLS SMTP encriptada | ||
25 | Pode ser problemático, devido ao bloqueio, por parte de alguns provedores de email, para evitar abuso | ||
2525 | Para não encriptado/TLS |
Configuração SMTP
Depois de se inscrever e verificar seu domínio de envio, selecione esse domínio e acesse a aba SMTP/API Settings. Em seguida, escolha Transactional ou Bulk Stream, dependendo do tipo de emails que você deseja enviar.
Copie e cole as credenciais SMTP fornecidas (para o fluxo que escolheu) no seu aplicativo.
Nota: A ativação do TLS é obrigatória, conforme mencionado nas credenciais.
Enviar com a Mailtrap API
Tokens da API do Mailtrap
Quando cria um domínio, um token é criado e denominado automaticamente com base na seguinte fórmula: [nome do domínio] + [token] + [ID do token]. Adicione ou remova permissões de tokens, clicando nas caixas correspondentes, no menu Tokens.
Saiba mais sobre como gerenciar tokens de API no nosso guia.
Mapeamento de API
Tipo de API | Mailtrap | SendGrid |
Email sending | Send email | |
User management | User management | Teammates |
Email Testing | Email Testing API |
Bibliotecas de API
No momento, existem cinco bibliotecas disponíveis no Mailtrap.
Linguagem de Programação | Mailtrap | SendGrid |
NodeJS | NodeJS SDK | NodeJS |
Ruby | Ruby SDK | Ruby |
PHP | PHP SDK | PHP |
Python | Python SDK | Python |
Elixir | Elixir SDK | Não suportado |
Autenticação de API
Usamos a autenticação Bearer. Passe o token da API para o código com o cabeçalho Authorization.
Permissões/Gerenciamento de usuários
Pode adicionar usuários à sua conta e gerenciar suas permissões se o seu plano for Business ou superior. Para adicionar usuários e para atribuir e editar suas permissões, clique no separador User Management e nos três pontos à direita.
Note que um usuário precisa de permissões de Administrador para se autenticar e enviar emails via API.
Leia mais sobre o gerenciamento de permissões de usuários.
ActionMailer Balancer para uma migração tranquila
Para aplicativos Ruby on Rails, o Mailtrap providencia o ActionMailer Balancer, que facilita a migração. A extensão ActionMailer permite distribuir proporcionalmente a carga de envio de emails entre dois serviços de envio diferentes e mitigar os riscos de envio.
Depois de instalar o Balancer em seu aplicativo, e de fazer ligeiras configurações, ele alargará o método de envio do ActionMailer.
Para mais informações sobre o boilerplate e o uso em programação, leia a página de Github ActionMailer Balancer do Mailtrap.