Email APIs : définition, avantages et fonctionnement

Créez-vous une page web e-commerce qui doit envoyer des emails transactionnels à la clientèle ? Faites-vous partie d’une équipe de développement qui crée une application web nécessitant l’envoi de messages à des listes de contacts ? Un ou une spécialiste de l’email marketing chargé·e de toucher des dizaines de milliers de personnes par des campagnes d’emails ciblées et personnalisées ? Ou un ou une manager qui a besoin d’un rapport de performance automatisé pour suivre l’évolution de ses campagnes d’email marketing ?

Si vous vous trouvez dans l’une de ces situations, vous avez besoin d’une email API.

Email API représentent une grande partie de ce que nous faisons chez Mailgun. Nous avons donc voulu prendre le temps de les démystifier pour vous. Dans cet article, nous allons commencer par les bases de ce qu’est une email API et de ses avantages. Ensuite, nous examinerons la différence entre l’utilisation du SMTP et d’une email API pour envoyer vos emails en masse ou vos emails transactionnels, et nous passerons en revue quelques exemples de notre API de Mailgun pour démontrer comment les email APIs peuvent stimuler votre flux de travail.

C’est parti.

Une interface de programmation d’application (API) est un mécanisme qui permet à deux applications de communiquer entre elles, et donne à différentes plateformes la capacité d’accéder aux ressources de l’une et de l’autre sans compromettre la sécurité ou le contrôle.

Une email API est un type spécifique d’API que vous pouvez utiliser pour connecter votre application web ou votre plateforme à un service d’emailing (ESP) afin d’utiliser ses capacités dans l’espace de travail de votre propre application. Cela signifie qu’au lieu de vous rendre séparément sur l’ESP pour envoyer votre campagne d’emails de marketing, vous pouvez désormais utiliser une email API pour envoyer des messages de manière programmatique depuis votre application.

Voici comment fonctionne l’email API de Mailgun :

1. L’email API de Mailgun vous permet d’intégrer votre application à Mailgun, un service d’emailing qui se concentre sur la livraison de vos emails.
2. Depuis votre application, vous pouvez utiliser une requête d’API pour envoyer vos messages d’email. Cette requête d’API porte le libellé « HTTP » ci-dessus. Nous expliquerons pourquoi ci-dessous lorsque nous aborderons le fonctionnement des API.
3. Mailgun reçoit votre demande d’envoi d’email et la compile avant de l’ajouter à la file d’attente. Les fournisseurs de services d’emails transactionnels comme Mailgun contribuent à simplifier vos efforts d’emailing en offrant des solutions de dépannage, des journaux de statut, des solutions de stockage, la gestion des réponses, des statistiques d’email et une livraison optimisée.
4. Ensuite, Mailgun livre votre message via l’API ou le protocole SMTP (Simple Mail Transfer Protocol) aux clients de messagerie de vos abonnés, comme Microsoft Outlook, AOL, Gmail ou Yahoo. Nous détaillerons le SMTP ci-dessous.
5. Les clients de messagerie de vos abonnés livrent ensuite les messages dans leurs boîtes de réception.

Une API d’email marketing est un type spécifique d’email API conçu pour gérer et automatiser des campagnes de marketing de manière programmatique. Elle vous permet d’envoyer des emails pour des promotions, des newsletters et des automatisations basées sur des déclencheurs directement depuis votre application ou logiciel. Elle fournit également des outils pour gérer les listes d’abonnés, personnaliser le contenu et obtenir des statistiques détaillées sur les performances des campagnes. 

L’utilisation d’une email API présente de nombreux avantages en termes d’efficacité, de sécurité et d’évolutivité. Les avantages de toute API résident dans la simplification des processus sans compromettre la sécurité, et vous conservez l’avantage d’exploiter les services depuis votre propre environnement. Cela facilite grandement l’extraction de statistiques et la supervision des rapports. Voici quelques-uns des avantages :

• Amélioration de la délivrabilité : Les email APIs reposent sur une infrastructure robuste et respectent les bonnes pratiques qui aident vos messages à atteindre les boîtes de réception prévues. En gérant automatiquement les rebonds et les désinscriptions, l’API s’assure que vos listes restent propres, ce qui signale aux services d’emailing (ESP) que vous êtes un expéditeur de bonne réputation et réduit le risque d’être signalé comme spam. 

• Renforcement de l’efficacité et de l’automatisation : L’API élimine le besoin de tâches manuelles et fastidieuses comme la création et l’envoi d’emails individuels. Ceci est particulièrement crucial pour les emails transactionnels (réinitialisations de mot de passe, confirmations de commande) et les campagnes de marketing à grande échelle.  

• Stimulation de la personnalisation et de l’engagement : Les email APIs peuvent s’intégrer à vos données clients pour personnaliser dynamiquement le contenu de chaque message. Cette capacité vous permet d’envoyer des emails hautement pertinents qui peuvent entraîner des taux d’ouverture et des taux de clics plus élevés, ainsi qu’une connexion plus forte avec votre clientèle. 

• Statistiques et informations en temps réel : Obtenez des statistiques d’emails pour suivre vos indicateurs et évaluer vos campagnes d’emailing. Utilisez une email API pour extraire et compiler des statistiques de délivrabilité telles que le taux d’ouverture, le nombre d’abonnés ayant cliqué sur votre bouton Call-to-Action (CTA), ou le nombre d’emails ayant généré des conversions. Cette boucle de rétroaction en temps réel vous permet de prendre des décisions fondées sur des données et d’optimiser vos campagnes d’emailing pour obtenir de meilleurs résultats. 

• Garantie de la sécurité des données et de la conformité : Protégez votre entreprise et votre clientèle avec des protocoles de sécurité avancés. Les API d’email marketing utilisent une authentification et un chiffrement sécurisés pour protéger les données sensibles de la clientèle.  

• Activation de l’automatisation basée sur les événements : Créez des webhooks qui envoient les données d’événements d’emails à un CRM. Utilisez des webhooks pour envoyer vos données d’événements à des outils externes de gestion de la relation client (CRM). Vous pouvez utiliser les email APIs pour créer des webhooks qui vous informent de la survenue d’un événement spécifique, comme un abonné demandant une réinitialisation de mot de passe, ce qui vous permet de programmer une action de suivi, comme l’envoi d’un email de réinitialisation de mot de passe. 

• Évolutivité : Lors de l’utilisation du SMTP pour l’envoi d’emails, tenez compte à la fois de votre volume d’envoi et de votre sécurité. Si votre volume d’envoi normal connaît des pics, les clients de messagerie pourraient signaler votre comportement comme étant du spam. Avec les appels d’API passant par des serveurs cloud, vous ne rencontrez pas les mêmes problèmes lorsque vous opérez à grande échelle. De plus, le SMTP n’intègre pas automatiquement la capacité de créer des couches d’authentification, nous détaillons davantage la différence entre API et SMTP ici 

Maintenant que nous savons ce que fait une email API et les avantages de son utilisation, Mais comment cela fonctionne-t-il ? Nous n’allons pas entrer dans tous les détails des API, mais nous pouvons vous donner une vue d’ensemble. Nous commencerons par l’architecture d’une API. Ensuite, nous aborderons les requêtes que vous pouvez effectuer auprès d’une API et les réponses que vous recevrez.

Les email APIs telles que l’API de Mailgun se conforment à une convention moderne appelée REST (REpresentational State Transfer), un style architectural d’API qui se concentre sur la manipulation de ressources. Ces ressources sont des objets de données comme des fichiers texte, des pages HTML ou des jeux de données.

Vous pouvez émettre des requêtes pour accéder ou modifier ces ressources via des points de terminaison URI (Unique Resource Indicator). Les URI sont similaires aux URL, mais ils ne peuvent qu’identifier une ressource, tandis que les URL localisent la ressource.

Par exemple, voici le point de terminaison d’envoi d’emails de l’email API de Mailgun :

                                

                                    v3/<domain>/messages
                                
                            

Vous pouvez envoyer des requêtes à ce point de terminaison pour envoyer des emails.

Les API RESTful utilisent des points de terminaison pour gérer les ressources et permettent à l’utilisateur ou l’utilisatrice de créer, lire, mettre à jour et supprimer des enregistrements en communiquant avec ces points de terminaison.

Voici quelques-uns des points de terminaison populaires de Mailgun :

Lors de l’utilisation d’une API, vous gérez et mettez à jour en émettant des requêtes :

• POST crée une nouvelle ressource
• GET demande une ressource
• PUT remplace une ressource
• PATCH met à jour une ressource
• DELETE supprime une ressource

Ces requêtes utilisent les méthodes standard du protocole HTTP (Hypertext Transfer Protocol). Parfois, vous verrez les termes « envoyer une requête HTTP » au lieu de « envoyer une requête via l’API », comme dans l’image de l’API de Mailgun ci-dessus. Ils signifient la même chose.

Voici un exemple de requête POST envoyée au point de terminaison Messages de l’email API de Mailgun :

                                

                                    curl -s --user 'api:YOUR_API_KEY' 
n    https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages 
n    -F from='Excited User <mailgun@YOUR_DOMAIN_NAME>' 
n    -F to=foo@example.com 
n    -F to=bar@example.com 
n    -F subject='Hello' 
n    -F text='Testing some Mailgun awesomeness!'
                                
                            

Cette requête indique à l’API d’envoyer un email en texte brut de Excited User à l’adresse mailgun@YOUR_DOMAIN_NAME vers foo@example.com et bar@example.com. L’email a pour objet « Hello » et contient le message « Testing some Mailgun awesomeness! ».

Il n’y a rien de pire que d’envoyer des emails ou des lignes de code à l’aveuglette, n’est-ce pas ? C’est pourquoi, selon le type de requête HTTP que vous avez envoyée, vous obtiendrez un type de réponse spécifique en retour. La réponse sera soit la donnée demandée (comme un message d’email stocké que vous souhaitez récupérer), soit une confirmation que l’action demandée a été effectuée. Les réponses sont formatées en XML, JSON, YAML ou d’autres formats. Par exemple, Mailgun renvoie des réponses JSON.

Par exemple, voici la réponse JSON que vous devriez recevoir de l’API de Mailgun si la requête POST ci-dessus a été envoyée correctement :

                                

                                    {rn  "message": "Queued. Thank you.",rn  "id": "<20111114174239.25659.5817@samples.mailgun.org>"rn}
                                
                            

Chez Mailgun, nous pensons que la simplicité et l’efficacité sont essentielles à une bonne expérience d’emailing. Vous pouvez utiliser l’API de Mailgun avec des langages de programmation et des frameworks comme Node.js, curl, Python, PHP, Microsoft.NET, Java et bien d’autres. Consultez nos bibliothèques pour commencer.

Voici quelques cas d’utilisation de nos email APIs :

• Utilisez notre Send API pour envoyer un email HTML sans effort et à grande échelle.
• Utilisez notre API de validation des emails pour vérifier une adresse email.
• Utilisez notre API de modèles pour créer, importer, stocker et versionner un modèle d’email HTML.

Entrons dans les détails pour chacun d’entre eux ci-dessous.

Utilisez une requête POST pour envoyer un email HTML avec des pièces jointes via la Send API de Mailgun.

Nous allons commencer par le code suivant :

                                

                                    curl -s --user 'api:YOUR_API_KEY' 
n    https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages 
n    -F from='Excited User <YOU@YOUR_DOMAIN_NAME>' 
n    -F to='foo@example.com' 
n    -F cc='bar@example.com' 
n    -F bcc='baz@example.com' 
n    -F subject='Hello' 
n    -F text='Testing some Mailgun awesomeness!' 
n    --form-string html='<html>HTML version of the body</html>' 
n    -F attachment=@files/cartman.jpg 
n    -F attachment=@files/cartman.png
                                
                            

Dans l’exemple ci-dessus, nous avons envoyé un message de Excited User depuis YOU@YOUR_DOMAIN_NAME à trois destinataires : foo@example.com, bar@example.com et baz@example.com. Nous avons joint le contenu de l’email HTML en le collant directement entre les balises . Nous avons également ajouté deux pièces jointes : cartman.jpg et cartman.png.

Vous devrez remplacer YOUR_API_KEY par la vôtre clé API. Gardez également à l’esprit que, si vous êtes un utilisateur basé dans l’UE, vous devez utiliser l’URL de base de notre environnement européen : https://api.eu.mailgun.net/.

Nous devrions recevoir la réponse suivante pour notre appel d’API :

                                

                                    {rn  "message": "Queued. Thank you.",rn  "id": "<20111114174239.25659.5817@samples.mailgun.org>"rn}
                                
                            

Passons à un autre cas d’utilisation. Nous utiliserons une requête GET pour valider une adresse email via l’API de validation des emails :

                                

                                    curl --user 'api:PRIVATE_API_KEY' -G 
n    https://api.mailgun.net/v4/address/validate 
n    --data-urlencode address='foo@mailgun.net'
                                
                            

Nous devrions obtenir la réponse suivante à notre appel d’API :

                                

                                    {rn    "address": "foo@mailgun.net",rn    "is_disposable_address": false,rn    "is_role_address": false,rn    "reason": [],rn    "result": "deliverable",rn    "risk": "low"rn}
                                
                            

Pour notre dernier cas d’utilisation, essayons de stocker un modèle en émettant une requête POST via l’API de modèles :

                                

                                    curl -s --user 'api:YOUR_API_KEY' -X POST 
n      https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/templates 
n      -F name="billing" rn      -F description="template description"rn      -F tag="v0" rn      -F template="template contents"
                                
                            

Dans cette requête, le paramètre name indique le nom du modèle. Cela sert à référencer le modèle dans d’autres appels d’API. Le paramètre tag identifie la version spécifique de ce modèle. Le paramètre template spécifie le contenu du modèle en lui-même. Ici, vous pouvez coller le contenu HTML du modèle directement dans la requête.

Nous devrions recevoir la réponse suivante :

                                

                                    {rn  "template": {rn      "createdAt": "Wed, 29 Aug 2021 23:31:13 UTC",rn      "description": "template description",rn      "name": "billing",rn      "version": {rn          "createdAt": "Wed, 29 Aug 2021 23:31:14 UTC",rn          "tag": "v0",rn      }rn  },rn  "message": "template has been stored"rn}
                                
                            

Les email APIs contribuent à la délivrabilité des emails en facilitant la messagerie pour les expéditeurs comme pour les destinataires. Une API s’assure qu’un message est envoyé à un public prédéterminé – généralement via une liste créée par l’expéditeur – et élimine le besoin de générer manuellement un grand nombre de messages chronophages.

La réduction des envois manuels permet également de limiter les erreurs humaines, comme des adresses email mal saisies ou des emails qui ne partent pas au moment voulu. Cela améliore la précision et la cohérence des messages d’emails envoyés, et entraîne des niveaux d’engagement plus forts avec le public ciblé.

Le rôle des API dans l’amélioration de la délivrabilité et de l’engagement est particulièrement important pour les organisations qui communiquent avec de vastes publics. Si cent clients demandent à une entreprise de réinitialiser le mot de passe de leur compte en l’espace d’une heure, cette demande serait presque impossible à satisfaire si l’entreprise tentait de créer manuellement cent emails pour sa clientèle (pensez à l’épisode de la chocolaterie dans I Love Lucy).

Les API ne sont pas toujours faciles à appréhender, mais elles rendent votre programme d’emailing plus fiable et plus efficace. Vous voulez plus d’informations sur la façon dont les email APIs de Mailgun peuvent vous aider ? Consultez nos Documentation API ou connectez-vous avec nos spécialistes de la délivrabilité.

Auteur·trice: Mary Dolan Mary Dolan is a former Community Marketing Manager and Copywriter at Sinch Mailgun. She was our social media guru and community leader. She was dialed into the email network and writes about the email topics and trends you're probably talking about.