Como migrar da API transacional do Mailchimp para o SendGrid

Em 2016, o Mandrill – agora conhecido como Mailchimp Transactional API – tornou-se um serviço complementar exclusivo do Mailchimp. Isso significava que apenas os membros mensais do Mailchimp podiam acessar os recursos de transação de e-mail do Mandrill. Para outros usuários, eles tiveram que escolher outra plataforma ou optar por pagar por uma conta do Mailchimp que nem sempre precisariam.

Entendemos então que muitos clientes procurariam um provedor alternativo que pudesse enviar e-mails com eficiência. O Twilio SendGrid queria ajudar a tornar esse processo o mais tranquilo possível.

Migrando da API Transacional do Mailchimp para o SendGrid

Como estritamente um complemento, a API Transacional do Mailchimp não está configurada para entregar e-mails de forma confiável na escala que você precisa para o seu negócio. Mas aqui no Twilio SendGrid, somos líderes em entrega de e-mail confiável e segura, processando mais de 100 bilhões de e-mails por mês para nossos principais remetentes, incluindo Uber, Airbnb e Spotify.

Neste tutorial, veremos as principais vantagens que você pode esperar ao enviar e-mails com o Twilio SendGrid. Nosso guia de migração passo a passo garantirá uma transição suave e simplificada.

A documentação do Twilio SendGrid é o melhor recurso para quem procura uma resposta para todas as perguntas relacionadas a SMTP, API e e-mail. É um ótimo lugar para começar antes de mergulhar nos detalhes mais básicos de mover e-mails e fazer chamadas de API.

Mas, primeiro, se você estiver procurando o equivalente do Twilio SendGrid de determinada funcionalidade da API Transacional do Mailchimp, a tabela a seguir pode ajudar:

Obtendo uma chave de API

Para começar, você precisa de uma conta Twilio SendGrid. Em seguida, você desejará criar uma chave de API que será usada para envio. Vá para Configurações → Chaves de API ou use este link se você estiver conectado à sua conta. É uma prática de segurança inteligente usar uma chave de API diferente para cada um dos seus diferentes aplicativos. Você também pode definir permissões para chaves de API ativando ou desativando o acesso de leitura ou gravação para endpoints individuais. Por enquanto, você só precisará de um que tenha acesso total ao Mail Send. (Observação: você deve passar pelo provisionamento antes de poder criar uma chave de API.)

Bibliotecas de API

Temos várias bibliotecas de API com suporte oficial que otimizam ainda mais o processo de envio de e-mail. Se você estiver reescrevendo qualquer código ou refatorando como se comunica com seu provedor de serviços de e-mail (ESP) como parte de sua migração, agora é um bom momento para utilizar uma dessas bibliotecas para acelerar sua integração:

• sendgrid-csharp – Biblioteca Oficial C#
• sendgrid-go – Biblioteca oficial do Go
• sendgrid-java – Biblioteca Java Oficial
• sendgrid-nodejs – Biblioteca oficial do Node.js
• sendgrid-perl – Biblioteca Perl Oficial
• sendgrid-php – Biblioteca oficial do PHP
• sendgrid-python – Biblioteca oficial do Python
• sendgrid-ruby – Biblioteca oficial do Ruby
• ti.sendgrid – Embalagem oficial de titânio

SMTP

Se você não estiver usando uma de nossas bibliotecas e enviando via Simple Mail Transfer Protocol ou SMTP, existem algumas diferenças que você deve saber. Para autenticar ao enviar via SMTP, forneça a string “apikey” como nome de usuário SMTP e use sua chave de API como senha. Em seguida, aponte seu nome de host para smtp.sendgrid.net.

Você pode se conectar usando SMTP via não criptografada ou TLS nas portas 25, 2525 e 587. Ou também pode se conectar via SSL na porta 465. Em geral, recomendamos a porta 587, pois ela tende a resultar em menos problemas com provedores de hospedagem .

O mecanismo para personalizar o e-mail enviado via SMTP é o nosso cabeçalho X-SMTPAPI . Esse cabeçalho permitirá que você defina substituições, envie solicitações de estilo de mala direta em lote e controle filtros (como rastreamento de cliques) que estão ativos para seu envio.

HTTP

O endpoint principal para envio de email é o endpoint mail.send . Você pode autenticar solicitações para esse endpoint por meio de um cabeçalho de autorização com sua chave de API apresentada como um token de portador. Encontre um exemplo mais detalhado em nossos documentos.

As personalizações permitem definir destinatários e metadados para cada mensagem, como valores de substituição para personalizar conteúdo ou custom_args para associar mensagens a IDs de usuário ou números de pedido. Existem vários exemplos de personalizações para casos de uso comuns. Você também pode encontrar chamadas de exemplo cURL .

Recursos, como rastreamento de cliques, podem ser configurados por meio dos parâmetros tracking_settings e mail_settings .

Para anexos enviados via HTTP, trate-os de maneira semelhante à API Transacional do Mailchimp, em que o conteúdo é codificado como Base64 e incorporado diretamente na carga JSON junto com as Extensões de correio da Internet multiuso ou informações MIME, como .

Observe que o endpoint mail.send do Twilio SendGrid é totalmente assíncrono. Aceitaremos a solicitação—desde que esteja bem formulada—e tentaremos processar sua entrega de e-mail o mais rápido possível. A API Transacional do Mailchimp permite que solicitações de menos de 10 e-mails sejam executadas de forma síncrona. O Twilio SendGrid, no entanto, não oferece o modo síncrono.

Você também pode agendar envios com até 72 horas de antecedência usando o parâmetro “send_at”.

Webhooks

O Twilio SendGrid fornece dois webhooks: o Event Webhook para postar eventos em tempo real e o Inbound Email Parse Webhook para receber emails e respondê-los programaticamente. As formas de dados e cargas úteis são um pouco diferentes do que a API Transacional do Mailchimp oferece—Twilio SendGrid não tem um equivalente ao webhook de “sincronização”.

Pontos de extremidade da API que não são de e-mail

Para endpoints de API que não enviam e-mail, confira a visão geral da API v3 . Usamos métodos HTTP intuitivos e códigos de resposta, na maioria dos casos, e aplicamos limites de taxa para chamadas. Apesar de não haver cronograma para parar de oferecer suporte, a API v2 ainda está disponível minimamente. Todas as novas integrações, no entanto, devem se inclinar para a v3. A autenticação da API v3 é acessível por meio de um cabeçalho de autenticação com um token de portador .

Perguntas frequentes sobre a migração para o Twilio SendGrid

P: Vocês oferecem suporte a modelos para emails transacionais?

R: Sim—e os modelos são dinâmicos! Os modelos transacionais do Twilio SendGrid apresentam suporte nativo para a sintaxe do Handlebars. Além de substituição e substituições básicas, você pode usar enumerações/iterar sobre listas, aproveitar condicionais e muito mais. Para saber mais sobre nossos modelos, clique aqui .

P: É possível testar meus e-mails sem precisar enviá-los?

R: Você pode habilitar o modo sandbox ao enviar e-mails via HTTP. Há também um endereço de “pia” que você pode usar para fins de teste.

P: É possível transferir meu endereço IP/reputação de remetente para o Twilio SendGrid?

R: Não podemos migrar um IP ou reputação, mas podemos ajudar a criar um novo IP para você automaticamente .

P: O Twilio SendGrid oferece suporte a TLS imposto?

R: Absolutamente. Nossos servidores de recebimento suportam TLS e descartam mensagens de saída que não estão em conformidade.

P: Posso permitir que meus destinatários definam os tipos de e-mails que desejam receber?

R: Sim! Dar aos seus destinatários mais controle permite que você envie e-mails para assinantes que realmente os desejam, o que é melhor para todos a longo prazo. Confira nossos grupos de cancelamento de inscrição para obter mais informações.

P: Você pode enviar e-mails para vários destinatários por solicitação?

R: Sim. Os clientes da API v3 que usam personalizações podem incluir até 1.000 destinatários por solicitação. Os usuários de SMTP podem incluir até 10.000 destinatários por mensagem, mas geralmente recomendamos que você use 1.000 destinatários por solicitação.

Saiba mais sobre como mudar da API Transacional do Mailchimp para o Twilio SendGrid