Amazon SES para Mailtrap:
Um Guia de Migração

Este guia fornece as principais formas de como migrar do Amazon SES para o Mailtrap facilmente: comparações de terminologia, configurações de SMTP ou API e outras especificações técnicas necessárias para uma troca descomplicada.

Diferenças entre Mailtrap e Amazon SES

  1. A principal diferença entre o Amazon SES e o Mailtrap é que não precisa de saber programar para configurar e integrar o Mailtrap.
  2. Os seus emails são armazenados em Email Logs no Mailtrap por até 60 dias, dependendo do seu plano. Também armazenamos conteúdo de email e dados importantes durante 3 a 15 dias.
  3. O Mailtrap disponibiliza planos mensais recorrentes, com a opção de solicitar um plano ou faturação anual. Ao contrário do Amazon SES, o Mailtrap não possui planos pré-pagos, mas tem o plano Free Forever, com 1000 emails, para que possa experimentar o nosso serviço. 
  4. O Mailtrap inclui Email Testing. Este é um produto em separado, que permite analisar os spam scores de HTML e CSS, e outros dados importantes, e corrigir bugs dos emails em pré-produção, desenvolvimento e QA antes de os enviar aos destinatários.
  5. O Mailtrap fornece o Bulk Stream, que permite enviar emails para vários destinatários de uma só vez (newsletters, promoções de marketing, atualizações de produtos, etc.).
  6. Outra diferença importante entre o Amazon SES e o Mailtrap é a forma como acessa todas as métricas. O Mailtrap possui as Estatísticas Práticas (Actionable Analytics) onde pode ver dados e estatísticas detalhados sobre os seus emails.
  7. O Amazon SES não permite incluir opções de cancelamento de assinatura nos emails sem código.

Mailtrap e Amazon SES – Semelhanças

  1. Suporte para envio com SMTP ou REST API.  
  2. Pode usar registros de return-path e DKIM para verificar um domínio.
  3. Ao enviar de um domínio que acabou de adicionar, a taxa de transferência fica limitada ou é criada uma fila de espera.
  4. Pode adicionar um arquivo .csv para importar endereços de email suprimidos.

Comparação de terminologia

  • Identity and Access Management (IAM)
  • Template (CreateTemplate – API operation)
  • Account-level suppression list
  • Message Tags (comparação mais próxima, mas a lógica é diferente)
  • Event Notifications
  • CONFIGURATIONSET (deve armazenar todos os cabeçalhos na configuração e criá-lo antecipadamente) ou usar

    SendRawEmail API method

  • Message Tags

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

  1. Depois de se registrar no Mailtrap, vá ao menu Sending Domains. Adicione seu domínio e verifique-o.

  2. Se escolher o serviço SMTP, altere as configurações de envio de acordo com as credenciais fornecidas pelo Mailtrap. Mais informações no cabeçalho SMTP abaixo.

  3. Se selecionar integração de API, confira a documentação de API e as bibliotecas do Mailtrap.

  4. Leve o tempo necessário para compreender as principais diferenças entre o Amazon SES e o 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. 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: 60% no AWS SES e 40% no Mailtrap) para mitigar os riscos de envio.

Começar

Começar a usar o Mailtrap não é complicado. Só precisa de criar uma conta e de configurar e verificar o seu domínio no menu Sending Domains. Confira o nosso Getting Started Guide para mais informações, mas aqui tem um guia rápido:

Verificação de domínio

  • Depois de se cadastrar e de adicionar e verificar seu domínio, ele passa por uma verificação de segurança que geralmente leva dois dias úteis. Durante esse período, sua taxa de transferência é limitada a 50 emails por hora, para evitar abuso do sistema. Leia nosso artigo Sending Limits para saber mais.
  • É fundamental que não exclua e adicione novamente durante a verificação de segurança, porque pode ser interpretado como um comportamento suspeito.
  • Pode remover o limite com um pedido de suporte, no qual terá de responder a algumas perguntas para comprovar a confiabilidade do seu domínio.
  • Certifique-se de definir opções de cancelamento de assinatura com o Mailtrap e de importar suas listas de supressão do Amazon SES.

SMTP

Mudar do serviço Amazon SES SMTP é simples. Verifique os cabeçalhos abaixo para entender melhor a compatibilidade e as etapas necessárias.

Servidores de Envio 

Servidores Amazon

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
email-smtp.us-east-2.amazonaws.com (+16) Mostrar todos
email-smtp.us-east-1.amazonaws.com
email-smtp-fips.us-east-1.amazonaws.com
email-smtp.us-west-1.amazonaws.com
email-smtp.us-west-2.amazonaws.com
email-smtp-fips.us-west-2.amazonaws.com
email-smtp.ap-south-1.amazonaws.com
email-smtp.ap-northeast-3.amazonaws.com
email-smtp.ap-northeast-2.amazonaws.com
email-smtp.ap-southeast-1.amazonaws.com
email-smtp.ap-southeast-2.amazonaws.com
email-smtp.ap-northeast-1.amazonaws.com
email-smtp.ca-central-1.amazonaws.com
email-smtp.eu-central-1.amazonaws.com
email-smtp.eu-west-1.amazonaws.com
email-smtp.eu-west-2.amazonaws.com
email-smtp.eu-west-3.amazonaws.com
email-smtp.eu-north-1.amazonaws.com
email-smtp.sa-east-1.amazonaws.com

Portas

PortaFunção
587Relay SMTP com TSL recomendado.
25Tráfego elevado, bloqueado por alguns provedores de email, devido a abuso.
2525Porta alternativa, caso você encontre problemas com outras portas.
465Para conexão SSL SMTP.

Configuração SMTP

Depois de verificar seu domínio com sucesso, selecione esse domínio, clique na aba SMTP/API Settings e selecione Transactional ou Bulk Stream, dependendo do tipo de emails que pretende de enviar.

Copie e cole as credenciais (para o fluxo que escolheu) no seu aplicativo ou projeto e envie um email de confirmação para verificar a configuração. Consulte nosso artigo Sending Domain Setup para obter mais informações sobre como fazer isso.

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

API

Sobre os tokens da API do Mailtrap

O Mailtrap cria um token automaticamente quando você cria um domínio, cuja permissão de acesso padrão é Domain Admin. Pode editar permissões para esse token para autorizá-lo com outros domínios em sua conta.

Para obter mais informações sobre como gerenciar tokens de API, consulte nosso guia.

Mapeamento da API

Tipo de APIMailtrapNome no SES
The BasicsGeneralWelcome
SendingSend emailSendEmail, SendRawEmail,
SendTemplatedEmail
Email TestingEmail Testing API

Bibliotecas de API

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

Linguagem de ProgramaçãoMailtrapAmazon SES
NodeJSNodeJS SDKNão suportado
RubyRuby SDKRuby SDK
PHPPHP SDKPHP SDK
PythonPython SDKPython SDK
ElixirElixir SDKNão suportado

Autenticação da API

O Mailtrap usa a autenticação Bearer. Por isso, precisa de passar o token da API no cabeçalho Authorization do seu email.

Gerenciamento de usuários

Do plano Business para cima, em Email API, você pode adicionar usuários à sua conta e gerenciar suas permissões. Ao clicar em User Management, poderá ver todos os usuários em uma conta específica, à qual pode facilmente adicionar novos membros e atribuir suas permissões.

Com base nas permissões que os usuários possuem, eles poderão visualizar, acessar e/ou modificar funcionalidades específicas de um aplicativo. 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.

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.