Como migrar do SparkPost para o SendGrid

Como pioneiro do e-mail transacional baseado em nuvem, vimos muitas mudanças e novas empresas no espaço. A tendência que vimos com essas empresas é que primeiro elas nos imitam, depois nos atacam, depois nos imitam um pouco mais. Além de fornecer orientações detalhadas sobre migração abaixo, queremos fornecer algumas reflexões sobre o valor que nossos clientes obtêm do SendGrid.

Primeiro, todos os nossos clientes, incluindo aqueles que usam nosso plano gratuito, recebem suporte de nossa equipe de suporte altamente experiente. Para clientes em nosso plano gratuito, esse suporte continua mesmo que eles não façam upgrade para um plano pago. E para todos os clientes, o suporte está disponível 24 horas por dia, todos os dias do ano, para todas as regiões onde nossos clientes estão localizados. Nossas ofertas de suporte fazem parte de nosso compromisso de tornar todos os usuários da plataforma SendGrid bem-sucedidos, estando disponíveis para eles a qualquer momento.

Em seguida, desde as menores startups até as maiores empresas, o e-mail programático orientado por API não é a única maneira que essas empresas usam o e-mail para alcançar os clientes. Eles também enviam boletins informativos, anúncios e campanhas para aumentar o envolvimento do cliente e impulsionar as compras. No SendGrid, nos dedicamos a atender a todas as necessidades de comunicação do cliente, com capacitação completa da equipe para marketing e promoção, bem como para programática. Nosso produto de campanhas de marketing permite que você envolva seus clientes usando nossa interface de usuário intuitiva com ferramentas avançadas de segmentação, análise e design.

Finalmente, há uma razão pela qual temos mais de 55.000 clientes pagantes processando mais de um bilhão de e-mails por dia. O motivo é que usamos nossa paixão pelas comunicações com o cliente e nossa profunda experiência em e-mail para ajudar nossos clientes a expandir seus negócios. A cada dia que trabalham conosco, nossos clientes sentem nossa cultura e nosso compromisso com seu sucesso.

Como migrar para o SendGrid do Sparkpost

Observação: o plano de migração a seguir foi fornecido como cortesia de nossa equipe de desenvolvimento da comunidade. Este tutorial irá destacar algumas diferenças entre enviar e-mail via SparkPost e enviar e-mail via SendGrid para ajudar a tornar a migração o mais fácil possível.

Se você quiser dar uma olhada antes de começar, confira a documentação do SendGrid. A Sala de Aula é um ótimo lugar para começar a aprender sobre e-mail antes de mergulhar na referência e nos detalhes da API.

Terminologia

Se você estiver procurando o equivalente do SendGrid de determinada funcionalidade do SparkPost, a tabela a seguir ajudará:

Obtendo uma chave de API

Primeiro você precisará de uma conta SendGrid. Em seguida, você deve criar uma chave de API que usará para enviar. Vá para Configurações -> Chaves de API ou use este link. Uma prática recomendada do SendGrid e de segurança é usar uma chave de API diferente para cada um dos seus diferentes aplicativos. As chaves de API têm permissões granulares, para que você possa ativar ou desativar o acesso de leitura ou gravação para endpoints individuais. Certifique-se de que a chave de API que você criou tenha acesso total ao Mail Send . (Observação: sua conta deve passar pelo provisionamento antes que você possa criar uma chave de API.)

Bibliotecas de API

Temos várias bibliotecas de API com suporte oficial para facilitar a integração para nossos clientes. Se você estiver reescrevendo qualquer código ou refatorando como se comunica com seu ESP como parte de sua migração, agora é um bom momento para avaliar essas bibliotecas:

• sendgrid-csharp – Biblioteca oficial C#
• sendgrid-go – Biblioteca oficial do Go
• sendgrid-java – Biblioteca Java oficial
• sendgrid-nodejs – Biblioteca oficial do NodeJS
• sendgrid-php – Biblioteca oficial do PHP
• sendgrid-python – Biblioteca oficial do Python
• sendgrid-ruby – Biblioteca oficial do Ruby

SMTP

Se você estiver enviando via SMTP, há algumas diferenças que você deve conhecer. Para autenticar, 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 criptografado ou TLS nas portas 25, 2525 e 587. Você 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 enviar e-mail é o endpoint Mail. As solicitações para esse endpoint são autenticadas por meio de um cabeçalho de autorização com sua chave de API apresentada como um token de portador. Você pode encontrar 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. Há 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 são configurados por meio dos parâmetros tracking_settings e mail_settings. Você também pode agendar envios com até 72 horas de antecedência usando o parâmetro “send_at”.

Os anexos enviados via HTTP são tratados de maneira semelhante ao SparkPost, onde o conteúdo é codificado como Base64 e incorporado diretamente na carga JSON junto com as informações MIME. Você pode ler mais sobre como incluir anexos na seção a seguir de nossa Sala de aula de documentação.

Webhooks

O SendGrid fornece dois webhooks: o Event Webhook para postar eventos em tempo real e o Inbound Parse Webhook para receber emails e respondê-los programaticamente. As formas de dados e cargas úteis são um pouco diferentes do que o SparkPost fornece.

Endpoints de 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. A API v2 está obsoleta, embora não haja um cronograma para parar de oferecer suporte a ela. Todas as novas integrações devem preferir v3. A autenticação da API v3 é realizada por um cabeçalho de autenticação com um token de portador.

Campanhas de marketing

Temos uma plataforma completa para gerenciar listas de contatos, criar e projetar modelos, testes A/B de diferentes modelos e agendamento de campanhas. Tudo isso é encapsulado em uma interface de usuário fácil de usar para não desenvolvedores. E, claro, você também pode acessar todos esses recursos por meio de nossa API de campanhas de marketing.

Algumas perguntas frequentes

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

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

P: Existe uma sandbox ou uma maneira de testar meus e-mails sem enviá-los?

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

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

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

P: O SendGrid oferece suporte a TLS imposto ?

R: Absolutamente. Você pode exigir que os servidores de recebimento ofereçam suporte a TLS e descartem mensagens que vão para servidores 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 sobre seus emails permite que você envie emails que as pessoas desejam, o que é melhor para todos. Confira os grupos de cancelamento de inscrição para obter mais informações.

Se estiver interessado em migrar para o SendGrid, você pode encontrar mais informações em sendgrid.com/pricing.