Comment migrer de SparkPost vers SendGrid

En tant que pionnier de la messagerie transactionnelle basée sur le cloud, nous avons vu de nombreux changements et de nouvelles entreprises dans l'espace. La tendance que nous avons constatée avec ces entreprises est qu'elles nous imitent d'abord, puis elles nous attaquent, puis elles nous imitent davantage. En plus de fournir des conseils de migration détaillés ci-dessous, nous souhaitons apporter quelques réflexions sur la valeur que nos clients obtiennent de SendGrid.

Tout d'abord, chacun de nos clients, y compris ceux qui utilisent notre plan gratuit, reçoivent l'assistance de notre équipe d'assistance hautement expérimentée. Pour les clients de notre forfait gratuit, cette assistance se poursuit même s'ils ne passent pas à un forfait payant. Et pour tous les clients, le support est disponible 24 heures sur 24, tous les jours de l'année, pour chaque région où se trouvent nos clients. Nos offres de support font partie de notre engagement à assurer le succès de tous les utilisateurs de la plateforme SendGrid en étant là pour eux à tout moment.

Ensuite, des plus petites startups aux plus grandes entreprises, le courrier électronique programmatique piloté par API n'est pas le seul moyen pour ces entreprises d'utiliser le courrier électronique pour atteindre leurs clients. Ils envoient également des newsletters, des annonces et des campagnes pour accroître l'engagement des clients et stimuler les achats. Chez SendGrid, nous nous engageons à répondre à tous les besoins de communication des clients, avec une équipe complète pour le marketing et la promotion ainsi que pour la programmation. Notre produit de campagnes marketing vous permet d'engager vos clients à l'aide de notre interface utilisateur intuitive avec des outils avancés de segmentation, d'analyse et de conception.

Enfin, il y a une raison pour laquelle nous avons plus de 55 000 clients payants qui traitent plus d'un milliard d'e-mails par jour. La raison en est que nous utilisons notre passion pour les communications avec les clients et notre expertise approfondie des e-mails pour aider nos clients à développer leur activité. Chaque jour où ils travaillent avec nous, nos clients ressentent notre culture et notre engagement envers leur succès.

Comment migrer vers SendGrid depuis Sparkpost

Remarque : Le plan de migration suivant a été fourni avec l'aimable autorisation de notre équipe de développement communautaire. Ce guide mettra en évidence certaines différences entre l'envoi d' e-mails via SparkPost et l'envoi d' e-mails via SendGrid pour faciliter au maximum la migration.

Si vous souhaitez jeter un coup d'œil avant de commencer, consultez la documentation de SendGrid. La salle de classe est un excellent endroit pour commencer à en apprendre davantage sur le courrier électronique avant de plonger dans la référence et les détails de l'API.

Terminologie

Si vous recherchez l'équivalent SendGrid de certaines fonctionnalités SparkPost, le tableau suivant vous aidera :

Obtenir une clé API

Vous aurez d'abord besoin d'un compte SendGrid. Ensuite, vous devez créer une clé API que vous utiliserez pour l'envoi. Allez dans Paramètres -> Clés API ou utilisez ce lien. Une bonne pratique SendGrid et de sécurité consiste à utiliser une clé API différente pour chacune de vos différentes applications. Les clés d'API ont des autorisations granulaires, vous pouvez donc activer ou désactiver l'accès en lecture ou en écriture pour des points de terminaison individuels. Assurez-vous que la clé API que vous créez dispose d'un accès complet à Mail Send . (Remarque : Votre compte doit réussir le provisionnement avant que vous puissiez créer une clé d'API.)

Bibliothèques d'API

Nous avons un certain nombre de bibliothèques d'API officiellement prises en charge pour faciliter l'intégration pour nos clients. Si vous réécrivez du code ou refactorisez la façon dont vous communiquez avec votre ESP dans le cadre de votre migration, le moment est venu d'évaluer ces bibliothèques :

• sendgrid-csharp – Bibliothèque C# officielle
• sendgrid-go – Bibliothèque officielle de Go
• sendgrid-java - Bibliothèque Java officielle
• sendgrid-nodejs – Bibliothèque officielle NodeJS
• sendgrid-php – Bibliothèque PHP officielle
• sendgrid-python - Bibliothèque Python officielle
• sendgrid-ruby – Bibliothèque Ruby officielle

SMTP

Si vous envoyez via SMTP, vous devez connaître quelques différences. Pour vous authentifier, fournissez la chaîne 'apikey' comme nom d'utilisateur SMTP et utilisez votre clé API comme mot de passe. Pointez ensuite votre nom d'hôte sur smtp.sendgrid.net .

Vous pouvez vous connecter en utilisant SMTP via non crypté ou TLS sur les ports 25, 2525 et 587. Vous pouvez également vous connecter via SSL sur le port 465. En général, nous recommandons le port 587 car il a tendance à entraîner le moins de problèmes avec les hébergeurs.

Le mécanisme de personnalisation des e-mails envoyés via SMTP est notre en-tête X-SMTPAPI. Cet en-tête vous permettra de définir des substitutions, d'envoyer des requêtes de style publipostage groupées et de contrôler les filtres (comme le suivi des clics) qui sont actifs pour votre envoi.

HTTP

Le point de terminaison principal pour l'envoi d'e-mails est le point de terminaison Mail. Les demandes adressées à ce point de terminaison sont authentifiées via un en-tête d'autorisation avec votre clé API présentée sous la forme d'un jeton porteur. Vous pouvez trouver un exemple plus détaillé dans nos docs.

Les personnalisations vous permettent de définir des destinataires et des métadonnées pour chaque message, telles que des valeurs de substitution pour personnaliser le contenu ou custom_args pour associer des messages à des ID utilisateur ou des numéros de commande. Il existe un certain nombre d'exemples de personnalisations pour des cas d'utilisation courants. Vous pouvez également trouver des exemples d'appels cURL.

Les fonctionnalités telles que le suivi des clics sont configurées via les paramètres tracking_settings et mail_settings. Vous pouvez également programmer des envois jusqu'à 72 heures à l'avance en utilisant le paramètre "send_at".

Les pièces jointes envoyées via HTTP sont traitées de la même manière que SparkPost, où le contenu est encodé en Base64 et intégré directement dans la charge utile JSON avec les informations MIME. Vous pouvez en savoir plus sur l'inclusion de pièces jointes dans la section suivante de notre salle de documentation.

Webhooks

SendGrid fournit deux webhooks : le Webhook d'événement pour publier des événements en temps réel et le Webhook Inbound Parse pour recevoir des e-mails et y répondre par programme. Les formes de données et les charges utiles sont un peu différentes de ce que fournit SparkPost.

Points de terminaison d'API non e-mail

Pour les points de terminaison d'API qui n'envoient pas d'e-mails, consultez la présentation de l'API v3. Nous utilisons des méthodes HTTP intuitives et des codes de réponse dans la plupart des cas, et appliquons des limites de débit pour les appels. L'API v2 est obsolète, bien qu'il n'y ait pas de calendrier pour arrêter de la prendre en charge. Toutes les nouvelles intégrations devraient préférer la v3. L'authentification API v3 est réalisée par un en-tête d'authentification avec un jeton Bearer.

Campagnes marketing

Nous disposons d'une plate-forme complète pour la gestion des listes de contacts, la création et la conception de modèles, le test A/B de différents modèles et la planification de campagnes. Tout cela est intégré dans une interface utilisateur facile à utiliser pour les non-développeurs. Et bien sûr, vous pouvez également accéder à toutes ces fonctionnalités via notre API Marketing Campaigns.

Quelques FAQ

Q : Prenez-vous en charge les modèles d'e-mails transactionnels ?

A : Oui, et ils sont dynamiques ! Les modèles transactionnels de SendGrid offrent une prise en charge native de la syntaxe Handlebars. En plus des remplacements et des substitutions de base, vous pouvez utiliser des énumérations/itérer sur des listes, tirer parti des conditions et bien plus encore. Pour en savoir plus, cliquez ici.

Q : Existe-t- il un bac à sable ou un moyen de tester mes e-mails sans les envoyer ?

R : Vous pouvez activer le mode bac à sable lors de l'envoi via HTTP. Il existe également une adresse « récepteur » que vous pouvez utiliser pour les tests.

Q : Est-il possible de transférer mon adresse IP/réputation d'expéditeur vers SendGrid ?

R : Nous ne pouvons pas migrer une adresse IP ou une réputation, mais nous pouvons vous aider à préparer automatiquement une nouvelle adresse IP.

Q : SendGrid prend-il en charge TLS appliqué ?

R : Absolument. Vous pouvez exiger que les serveurs de réception prennent en charge TLS et supprimer les messages destinés aux serveurs non conformes.

Q : Puis-je autoriser mes destinataires à définir les types d'e-mails qu'ils souhaitent recevoir ?

R : Oui. Donner à vos destinataires plus de contrôle sur leurs e-mails vous permet d'envoyer des e-mails que les gens veulent, ce qui est mieux pour tout le monde. Consultez les groupes de désinscription pour plus d'informations.

Si vous souhaitez migrer vers SendGrid, vous pouvez trouver plus d'informations sur sendgrid.com/pricing.