Comment migrer de l'API transactionnelle Mailchimp vers SendGrid

En 2016, Mandrill, désormais connu sous le nom d'API transactionnelle Mailchimp, est devenu un service complémentaire exclusif à Mailchimp. Cela signifiait que seuls les membres mensuels de Mailchimp pouvaient accéder aux fonctionnalités de transaction par e-mail de Mandrill. Pour les autres utilisateurs, ils devaient soit choisir une autre plate-forme, soit choisir de payer pour un compte Mailchimp dont ils n'auraient pas toujours besoin.

Nous avons alors compris que de nombreux clients chercheraient un autre fournisseur capable d'envoyer efficacement des e-mails. Twilio SendGrid voulait aider à rendre ce processus aussi fluide que possible.

Migration de l'API transactionnelle Mailchimp vers SendGrid

En tant que complément strictement complémentaire, l'API transactionnelle de Mailchimp n'est pas configurée pour fournir de manière fiable des e-mails à l'échelle dont vous avez besoin pour votre entreprise. Mais ici, chez Twilio SendGrid, nous sommes les leaders de la livraison d'e-mails fiables et sécurisés, traitant plus de 100 milliards d'e-mails par mois pour nos principaux expéditeurs, notamment Uber, Airbnb et Spotify.

Dans ce didacticiel, nous allons passer en revue les principaux avantages auxquels vous pouvez vous attendre lors de l'envoi d'e-mails avec Twilio SendGrid. Notre guide de migration étape par étape assurera une transition fluide et simplifiée.

La documentation Twilio SendGrid est la meilleure ressource pour ceux qui recherchent une réponse à toutes les demandes liées au SMTP, à l'API et aux e-mails. C'est un excellent point de départ avant de plonger dans les détails les plus élémentaires du transfert de courrier et des appels d'API.

Mais d'abord, si vous recherchez l'équivalent Twilio SendGrid de certaines fonctionnalités de l'API transactionnelle Mailchimp, le tableau suivant peut vous aider :

Obtenir une clé API

Pour commencer, vous avez besoin d'un compte Twilio SendGrid. Ensuite, vous voudrez créer une clé API que vous utiliserez pour l'envoi. Allez dans Paramètres → Clés API ou utilisez ce lien si vous êtes connecté à votre compte. C'est une pratique de sécurité judicieuse d'utiliser une clé API différente pour chacune de vos différentes applications. Vous pouvez également définir des autorisations pour les clés d'API en activant ou en désactivant l'accès en lecture ou en écriture pour des points de terminaison individuels. Pour l'instant, vous n'en aurez besoin que d'un qui a un accès complet à Mail Send. (Remarque : vous devez réussir le provisionnement avant de pouvoir créer une clé d'API.)

Bibliothèques d'API

Nous avons un certain nombre de bibliothèques d'API officiellement prises en charge qui optimisent davantage le processus d'envoi d'e-mails. Si vous réécrivez du code ou refactorisez la façon dont vous communiquez avec votre fournisseur de services de messagerie (ESP) dans le cadre de votre migration, le moment est venu d'utiliser l'une de ces bibliothèques pour accélérer votre intégration :

• sendgrid-csharp – Bibliothèque C# officielle
• sendgrid-go – Bibliothèque officielle de Go
• sendgrid-java – Bibliothèque Java officielle
• sendgrid-nodejs – Bibliothèque officielle Node.js
• sendgrid-perl – Bibliothèque Perl officielle
• sendgrid-php – Bibliothèque PHP officielle
• sendgrid-python – Bibliothèque Python officielle
• sendgrid-ruby – Bibliothèque Ruby officielle
• ti.sendgrid – Enveloppe Titanium officielle

SMTP

Si vous n'utilisez pas l'une de nos bibliothèques et que vous envoyez via Simple Mail Transfer Protocol ou SMTP, vous devez connaître quelques différences. Pour vous authentifier lors de l'envoi via SMTP, fournissez la chaîne "apikey" comme nom d'utilisateur SMTP et utilisez votre clé API comme mot de passe. Ensuite, faites pointer votre nom d'hôte vers smtp.sendgrid.net.

Vous pouvez vous connecter en utilisant SMTP via non crypté ou TLS sur les ports 25, 2525 et 587. Ou, 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.send . Vous pouvez authentifier les demandes adressées à ce point de terminaison via un en-tête d'autorisation avec votre clé API présentée sous la forme d'un jeton Bearer. Trouvez 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 plusieurs 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, peuvent être configurées via les paramètres tracking_settings et mail_settings .

Pour les pièces jointes envoyées via HTTP, gérez-les d'une manière similaire à l'API transactionnelle Mailchimp, où le contenu est encodé en Base64 et intégré directement dans la charge utile JSON aux côtés des extensions de messagerie Internet polyvalentes ou des informations MIME, comme so .

Notez que le point de terminaison mail.send de Twilio SendGrid est entièrement asynchrone. Nous accepterons la demande - tant qu'elle est bien formée - et tenterons de traiter sa livraison par courrier dès que possible. L'API transactionnelle Mailchimp permet aux demandes de moins de 10 e-mails de s'exécuter de manière synchrone. Twilio SendGrid, cependant, n'offre pas de mode synchrone.

Vous pouvez également programmer des envois jusqu'à 72 heures à l'avance en utilisant le paramètre "send_at".

Webhooks

Twilio SendGrid fournit deux webhooks : le Webhook d'événement pour publier des événements en temps réel et le Webhook Inbound Email 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 propose l'API transactionnelle Mailchimp - Twilio SendGrid n'a pas d'équivalent au webhook "sync".

Points de terminaison d'API autres que les e-mails

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. Bien qu'il n'y ait pas de calendrier pour arrêter de le prendre en charge, l'API v2 est toujours disponible de manière minimale. Toutes les nouvelles intégrations, cependant, devraient pencher vers la v3. L'authentification API v3 est accessible via un header d'authentification avec un jeton Bearer .

FAQ sur la migration vers Twilio SendGrid

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

R : Oui, et les modèles sont dynamiques ! Les modèles transactionnels de Twilio 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, etc. Pour en savoir plus sur nos modèles, cliquez ici .

Q : Est-il possible pour moi de tester mes e-mails sans avoir à les envoyer ?

R : Vous pouvez activer le mode bac à sable lors de l'envoi d'e-mails via HTTP. Il existe également une adresse « récepteur » que vous pouvez utiliser à des fins de test.

Q : Est-il possible de transférer mon adresse IP/réputation d'expéditeur vers Twilio 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 : Twilio SendGrid prend-il en charge TLS appliqué ?

R : Absolument. Nos serveurs de réception prennent en charge TLS et suppriment les messages sortants qui ne sont pas conformes.

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

R : Oui ! Donner plus de contrôle à vos destinataires vous permet d'envoyer des e-mails aux abonnés qui les souhaitent vraiment, ce qui est mieux pour tout le monde à long terme. Consultez nos groupes de désinscription pour plus d'informations.

Q : Pouvez-vous envoyer des e-mails à plusieurs destinataires par demande ?

R : Oui. Les clients de l'API v3 utilisant des personnalisations peuvent inclure jusqu'à 1 000 destinataires par demande. Les utilisateurs SMTP peuvent inclure jusqu'à 10 000 destinataires par message, mais nous vous recommandons souvent d'utiliser 1 000 destinataires par demande.

En savoir plus sur le passage de l'API transactionnelle Mailchimp à Twilio SendGrid