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

  1. 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.
  2. Pode solicitar um plano/faturação anual para o Mailtrap, além de planos faturados mensalmente.
  3. 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.
  4. O Mailtrap não possui a opção de agendar o envio de emails.

Comparação de terminologia

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

Fluxo geral de migração passo-a-passo

  1. 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.

  2. Se usa o serviço SMTP, altere as suas configurações em conformidade.

  3. Se usa API, confira as nossas bibliotecas e documentação de API.

  4. 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.

  5. 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

PortaFunçãoSuporte MailtrapSuporte SendGrid
587Recomendado para conexão TLS SMTP encriptada
25Pode ser problemático, devido ao bloqueio, por parte de alguns provedores de email, para evitar abuso
2525Para não encriptado/TLS
465Para conexão SSL SMTP

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 APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Bibliotecas de API

No momento, existem cinco bibliotecas disponíveis no Mailtrap.

Linguagem de ProgramaçãoMailtrapSendGrid
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython
ElixirElixir SDKNã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.