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é 60 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
  • 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. 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 tanto na Homepage do aplicativo, como no separador Sending Domains, no menu Sending.

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 100 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

SMTP Endpoints

live.smtp.mailtrap.iosmtp.sendgrid.net

SMTP Ports

PortFunctionMailtrap supportSendGrid support
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 cadastrar e verificar seu domínio de envio, vá ao separador API and SMTP, no menu Sending Domains. Selecione SMTP em Integrations.

Copie e cole, no seu aplicativo, as credenciais SMTP fornecidas.

Nota: A ativação do TLS é obrigatória, conforme mencionado nas credenciais.

Enviar com a Mailtrap API

Mailtrap API tokens

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

Saiba mais sobre como gerenciar tokens de API no nosso guia.

API Mapping

API typeMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingSandbox API

Bibliotecas de API

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

Linguagem de ProgramaçãoMailtrapSendgrid
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython

API Authentication

Usamos a Bearer authentication. 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 como gerenciar permissões de usuários.

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.