Comment migrer de Dyn Email Delivery vers SendGrid

Avec l'annonce récente de l'acquisition de Dyn par Oracle pour son activité de gestion DNS, les gens recherchent des solutions entièrement axées sur le courrier électronique. Notre équipe a eu une augmentation du nombre de questions sur la migration de la livraison d'e-mails Dyn vers SendGrid, nous avons donc décidé de mettre en place ce guide.

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.

Depuis notre création, nous sommes une entreprise basée uniquement sur les API et uniquement sur les e-mails, et vous constaterez que cela se reflète dans nos produits. Notre point de terminaison de messagerie HTTP, nos webhooks, notre API SMTP et non-e-mail sont au cœur de notre activité, et vous verrez que cela se reflète dans leurs capacités. Ce guide visera à vous donner les bases de la configuration de SendGrid tout en mettant en évidence les fonctionnalités utiles qui manquent à votre fournisseur actuel.

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

Alors que Dyn fournit des SDK officiels en Python et PHP, nous avons sept 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. Tout d'abord, vous n'avez pas à vous soucier d'utiliser un serveur SMTP spécifique en fonction de la taille de votre message, comme Dyn l'exige. Nous acceptons également les messages jusqu'à ~19,5 Mo par rapport à la limite de 10 Mo de Dyn. 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 .

Nous proposons également des options de port supplémentaires par rapport à Dyn. 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 clé/valeur, d'envoyer des requêtes groupées de style publipostage et de contrôler les filtres (comme le suivi des clics) qui sont actifs pour votre envoi. Vous pouvez regrouper les e-mails par catégorie ou suivre les métadonnées par e-mail avec unique_args. Ce sont des fonctionnalités puissantes qui peuvent réduire votre temps d'envoi et la quantité de bande passante nécessaire pour vos transactions par e-mail, et qui méritent d'être explorées.

HTTP

Le point de terminaison principal pour l'envoi d'e-mails est le point de terminaison mail/send. 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.

Par rapport à l'API HTTP de Dyn, notre point de terminaison fournit plus de fonctionnalités pour vous permettre de personnaliser et de gérer vos destinataires, et même d'envoyer plusieurs messages différents en une seule requête.

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".

Nous facilitons également l'ajout de pièces jointes à votre demande d'API. Encodez simplement votre fichier sous forme de chaîne Base64 et intégrez-le directement dans la charge utile JSON avec les informations de contenu 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 d'e-mails en temps réel tels que les désinscriptions, les rebonds, etc., et le Webhook Inbound Parse pour recevoir des e-mails et y répondre par programme.

Ces fonctionnalités ne sont pas disponibles sur Dyn, mais peuvent être utiles pour ajouter une automatisation supplémentaire à votre gestion des e-mails. Ils valent le coup d'œil lorsque vous commencez à vous installer.

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

Une autre fonctionnalité que nous proposons est une plate-forme de campagnes marketing robuste, vous permettant de gérer vos listes, de créer des segments dynamiques, de télécharger vos actifs et de concevoir votre modèle d'e-mail avec un éditeur visuel, d'effectuer des tests A/B automatiques, etc. Et bien sûr, il y a aussi une API ouverte derrière toutes ces fonctionnalités.

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.