Comprendre la validation des adresses email avec des services externes

Rebond.

Ce n’est pas ce que vous voulez entendre lors de l’envoi de votre campagne d’emailing.

Vous avez fait votre étude de marché, créé un modèle d’email HTML responsif, rédigé un texte brillant et ajouté des visuels accrocheurs. Votre campagne d’email marketing est vouée au succès, n’est-ce pas ?

Tout dépend de la délivrabilité de vos emails et de votre taux de livraison des emails. La délivrabilité décrit quelle proportion de vos emails atterrit dans le dossier spam du destinataire par rapport à sa boîte de réception. Mais votre taux de livraison représente le nombre de vos emails qui sont effectivement livrés.

Vous pouvez résoudre le problème du taux de livraison des emails de plusieurs manières, par exemple en implémentant des règles de validation avec des expressions régulières (regex) et d’autres validations personnalisées lors de la collecte des adresses email pour vos campagnes. Mais en fin de compte, ces options ont leurs limites. Ne vous inquiétez pas : c’est pourquoi Mailgun assure vos arrières avec son API de validation des emails.

Dans cet article, nous allons aborder trois façons d’effectuer des validations des emails sur Mailgun. Ensuite, nous verrons comment intégrer l’API de Mailgun à un client externe, comme Salesforce, afin que vous puissiez utiliser notre API de validation des emails pour booster vos efforts de marketing digital sur d’autres plateformes.

La validation des adresses email, aussi appelée vérification des emails, est un processus qui vérifie si une adresse email est livrable, ou plus simplement, s’il s’agit d’une adresse email valide.

Par exemple, bon nombre de vos utilisateurs peuvent faire des fautes de frappe ou de formatage en tapant leurs emails, surtout s’ils saisissent ces informations depuis des appareils mobiles avec de petits écrans. La validation des emails détecte ces erreurs de syntaxe ou fautes de frappe et évalue si la mauvaise donnée est une erreur de bonne foi, une fausse piste intentionnelle ou une menace potentielle de cybersécurité.

La validation des adresses email est importante car elle permet de faire ce qui suit :

• Augmenter le taux de livraison : diminuez votre taux de rebond en vérifiant les adresses email et en écartant les utilisateurs invalides que les serveurs de messagerie ne peuvent pas atteindre.
• Nettoyer et organiser votre liste de diffusion : gardez votre liste de diffusion à jour et organisée en éliminant les adresses email inactives ou invalides.
• Générer un taux de conversion plus élevé : comme vous concentrez vos efforts sur les emails qui ont été validés, vous ne gaspillez pas de messages vers des adresses email invalides. Cela vous permet de cibler des destinataires actifs et d’atteindre un taux de conversion plus élevé.
• Protéger votre réputation d’expéditeur : votre Adresse IP réputation et celle de votre domaine sont les statistiques utilisées par le client de messagerie pour décider de livrer ou non vos messages. Elles ont également un impact sur le fait que vos emails atterrissent dans la boîte de réception de votre destinataire ou dans le dossier spam. Maintenez une bonne réputation d’expéditeur en ciblant des adresses email avec des utilisateurs valides.

Pourquoi laisser le succès de votre campagne d’emailing au hasard alors que vous pouvez facilement valider les adresses email ?

Chez Mailgun, nous proposons une service de vérification d’emails entièrement intégrée à notre suite de fonctionnalités et services de délivrabilité des emails. Vous n’aurez plus à jongler entre différentes plateformes et sources de données pour vérifier si vos campagnes d’emailing vont générer des rebonds.

Notre API de validation des emails qui peut être interrogée au point de terminaison suivant : https://api.mailgun.net/v4/address/validate. L’API inspecte de façon programmatique plusieurs aspects d’une adresse email pour vérifier ce qui suit :

• La syntaxe de l’adresse email est correcte.
• Le domaine est bien paramétré pour recevoir des emails.
• L’adresse email existe.
• L’adresse n’a pas d’événements de rebond en cache provenant du réseau Mailgun.
• L’adresse email n’est pas une adresse à haut risque.
• L’adresse email n’est pas générique ou basée sur un poste, comme info@mailgun.com ou admin@mailgun.com.
• L’adresse email n’est pas jetable.
• L’adresse email ne contient pas de faute de frappe dans le domaine.
• L’adresse email ne se trouve pas sur un domaine catch-all.
  • Si le domaine est catch-all, nous marquerons l’adresse comme livrable si nous constatons de l’engagement sur celle-ci.

Nous savons à quel point il est important pour vous de conserver une liste d’adresses email vérifiées et livrables pour réduire le taux d’emails rebondis qui pourraient nuire à votre réputation d’expéditeur.

Mailgun propose la vérification des adresses email de trois manières :

• Vérifier les adresses email d’une liste de diffusion
• Vérifier une seule adresse email
• Vérifier des adresses email fournies en masse via un fichier CSV

Si vous n’êtes pas prêt à vous plonger dans le codage, consultez notre fonctionnalité de liste de diffusion sur notre plateforme, comme illustré ci-dessous. Vous pouvez vérifier les membres d’une liste de diffusion d’un simple clic depuis votre panneau de contrôle. N’oubliez pas que vous ne pouvez avoir qu’un maximum de 2,5 millions de membres dans votre liste de diffusion.

Si vous êtes prêt à coder, voyons ci-dessous comment effectuer une vérification d’adresse email unique ou une vérification en masse d’emails via notre API.

Avant de vous plonger dans les tutoriels, assurez-vous de vous être inscrit à Mailgun si ce n’est pas déjà fait. Une fois que vous avez un compte, accédez au tableau de bord, cliquez sur l’onglet Sécurité de l’API et copiez votre Clé API privée, comme illustré ci-dessous. Vous en aurez besoin à des fins d’authentification.

Les tutoriels suivants utiliseront l’API de Mailgun, donc une familiarité avec les API RESTful, curl et JSON est fortement recommandée, mais pas obligatoire.

Commençons par le cas d’usage le plus basique : la vérification d’une seule adresse email. Nous pouvons faire une requête GET à l’API de validation des emails de la manière suivante :

                                

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

N’oubliez pas de fournir votre Clé API privée au lieu de la clé PRIVATE_API_KEY de l’exemple ci-dessus. De plus, vous pouvez fournir l’adresse email que vous vérifiez en tant que paramètre pour l’adresse.

Si vous avez rédigé votre requête correctement, vous devriez obtenir la réponse suivante :

                                

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

Les deux parties les plus importantes de cette réponse sont les paramètres result et risk.

Le paramètre result correspond à notre évaluation principale de l’adresse email que vous avez soumise pour vérification. Il peut contenir les valeurs suivantes :

• deliverable : l’adresse du destinataire est valide et devrait accepter un email de votre part.
• undeliverable : l’adresse du destinataire est invalide et entraînera un rebond si vous envoyez un message.
• do_not_send : l’adresse du destinataire est très risquée et aura un impact négatif sur votre réputation d’expéditeur si vous envoyez un message à cette adresse.
• catch_all : la validité de l’adresse du destinataire ne peut pas être déterminée car le service d’emailing (ESP) accepte tous les emails, que la messagerie du destinataire existe ou non.
• unknown : la validité de l’adresse du destinataire ne peut pas être déterminée pour plusieurs raisons potentielles. Veuillez vous référer au tableau reason associé renvoyé dans la réponse.

Le paramètre risk est notre évaluation de l’impact que l’envoi de messages à une adresse donnée peut avoir sur votre réputation d’expéditeur. Ce paramètre peut contenir les valeurs suivantes :

• low : l’adresse email est probablement légitime et l’envoi d’un email à cette adresse a une faible probabilité de nuire à votre réputation d’expéditeur si l’adresse a été obtenue de manière légitime. 
• medium : il s’agit de notre état par défaut ou neutre pour le calcul des risques. Une adresse email qui n’est pas considérée comme présentant un risque faible (low) ou élevé (high) sera par défaut classée comme présentant un risque moyen (medium).
• high : une adresse email qui présente un risque élevé de nuire à votre réputation d’expéditeur ou lorsqu’elle est utilisée pour une vérification sur votre plateforme. Vous devriez examiner cette adresse email pour remettre en question sa validité.

Voici une brève explication des autres paramètres dans le corps de la réponse :

• address : renvoie l’adresse email en cours de vérification.
• is_disposable_address : cette clé renvoie une valeur true ou false, selon que l’adresse email vérifiée est une adresse email jetable ou non.
• is_role_address : renvoie une valeur true ou false, selon que l’adresse email vérifiée est une adresse de rôle ou non.
• reason : ce tableau fournit des informations supplémentaires si nous ne pouvons pas vérifier correctement une adresse email, telles que mailbox_does_not_exist ou high_risk_domain. Si votre risk est medium ou high, ce tableau fournira une explication.

Et voilà pour ce qui est d’effectuer une validation de base d’adresse email. Notez que vous pouvez également effectuer la vérification d’une seule adresse email via une requête POST. Consultez nos Documentation API pour plus de détails.

Mais que faire si vous avez des centaines (ou des milliers !) d’adresses email à vérifier ? Les envoyer une par une est une perte de temps et de ressources informatiques.

La vérification en masse vous permet de vérifier une liste d’adresses email. Une fois toutes les vérifications terminées, vous pouvez accéder aux résultats via un lien download_url. Gardez à l’esprit que vous devez fournir votre liste d’adresses email sous forme de fichier CSV ou GZIP brut. Vous devez également télécharger votre fichier en tant que multi-part/form-data où le fichier est défini par file. 

Ci-dessous, examinons deux requêtes d’API pour gérer vos vérifications en masse :

• Créer une tâche de vérification en masse
• Obtenir le statut d’une tâche de vérification en masse

Une fois que vous avez préparé et importé votre liste d’adresses email selon les spécifications ci-dessus, il est facile de créer une tâche de vérification des emails en masse. Nous utiliserons une requête POST vers notre API de validation des emails comme illustré ci-dessous :

N’oubliez pas de remplacer YOUR_API_KEY par votre Clé API privée, de nommer votre liste pour LIST_NAME et d’insérer le chemin de votre fichier pour file.

Vous devriez recevoir la réponse suivante :

                                

                                    {rn "id":"myemails"rn "message": "The validation job was submitted."rn}
                                
                            

Vous recevrez un message confirmant que votre tâche a été soumise avec succès. L’id correspond au nom de la liste que vous avez fourni.

Nous vous promettons que vos vérifications en masse ne prendront pas beaucoup de temps : pensez en minutes, pas en heures. Nous en sommes capables car notre outil de vérification d’emails utilise notre cache de milliards d’adresses email comme source principale pour permettre une vérification ultra-rapide. Mais au cas où vous auriez besoin de vérifier le statut de votre tâche de vérification en masse, vous pouvez utiliser la requête GET suivante :

                                

                                    curl -s --user 'api:YOUR_API_KEY' -G 
n    https://api.mailgun.net/v4/address/validate/bulk/LIST_NAME
                                
                            

N’oubliez pas de remplacer YOUR_API_KEY par votre Clé API privée et de nommer votre liste pour LIST_NAME. Voici un exemple de réponse à votre requête :

                                

                                    {rn  "created_at": "Tue, 26 Feb 2021 21:30:03 GMT",rn  "download_url": {rn    "csv": "<download_link>",rn    "json": "<download_link>"rn  },rn  "id": "bulk_validations_sandbox_mailgun_org",rn  "quantity": 207665,rn  "records_processed": 207665,rn  "status": "uploaded",rn  "summary": {rn    "result": {rn      "deliverable": 181854,rn      "do_not_send": 5647,rn      "undeliverable": 12116,rn      "catch_all" : 2345,rn      "unknown": 5613rn    },rn    "risk": {rn      "high": 17763,rn      "low": 142547,rn      "medium": 41652,rn      "unknown": 5613rn    }rn  }rn}
                                
                            

Vous pouvez voir un résumé des vérifications de vos emails, y compris la répartition des résultats (result) et des risques (risk). Vous pouvez également voir le statut de votre tâche, c’est-à-dire l’état actuel de la requête de vérification de la liste, tel que created, processing, completed, uploading, uploaded et failed.

Une fois votre tâche de vérification en masse téléchargée avec succès, vous pouvez utiliser les liens download_url pour accéder aux détails concernant chaque adresse email de votre liste.

Et voilà, vous avez vérifié vos emails et vous êtes prêt à envoyer votre campagne d’emailing.

Voyons comment un administrateur Salesforce peut configurer Salesforce pour une utilisation avec l’API de validation des emails de Mailgun. Pour ce faire, nous utiliserons les External Services, un moyen de connecter Salesforce à des API externes sans utiliser de code. Ensuite, nous lancerons une validation des emails depuis Salesforce. Nous allons procéder selon les étapes suivantes :

1. Créer des informations d’identification nommées (Named Credential) pour l’API de Mailgun sur Salesforce.
2. Configurer les Services externes (External Services) sur la plateforme Salesforce.
3. Créer un Screen Flow (flux d’écran) pour utiliser l’API de validation des emails de Mailgun dans Salesforce.
4. Lancer une validation des emails depuis Salesforce.

Examinons ces étapes plus en détail. N’oubliez pas que vous aurez besoin d’un compte Mailgun avec un abonnement qui inclut la fonctionnalité de validation des emails de Mailgun Optimize.

Nous allons commencer par créer un identifiant nommé (Named Credential). Pour ce faire :

1. Sur la plateforme Salesforce, allez dans Configuration > Informations d’identification nommées.

2. Cliquez sur le bouton Nouveau pour créer de nouvelles informations d’identification nommées.

3. Spécifiez les valeurs suivantes :

• Label = Mailgun Email Address Verifications
• Name = Mailgun_Email_Verification_API
• Certificate = laisser vide
• Identity Type = Principal nommé
• Authentication Protocol = Authentification par mot de passe
• Username = api
• Password = Votre clé API privée de votre compte Mailgun.
• Generate Authorization Header = true

4. Cliquez sur Enregistrer.

À présent, utilisons les External Services sur la plateforme Salesforce pour intégrer l’API de Mailgun. Nous allons le faire en suivant ces étapes :

1. Dans Salesforce, allez dans Configuration > Services externes.

2. Sélectionnez Nouveau service externe.

3. Sélectionnez À partir de la spécification de l’API, puis cliquez sur Suivant

4. Spécifiez ces valeurs pour les champs suivants :

• External Service Name = MailgunEmailVerificationsExternalService 
• Sélectionner des informations d’identification nommées = le nom des informations d’identification nommées que vous avez créées ci-dessus (Mailgun Email Address Verifications dans cet exemple)
• Description = Service de vérification des adresses email de Mailgun
• Modifiez le bouton radio sur “Service Schema Complete JSON” et saisissez le schéma Swagger suivant :

                                

                                    {rnrn    "swagger": "2.0",rnrn    "info": {rnrn        "description": "Mailgun Email Address Validation API",rnrn        "version": "4.0",rnrn        "title": "Mailgun Email Address Validation API"rnrn    },rnrn    "host": "api.mailgun.net",rnrn    "schemes": [rnrn        "https"rnrn    ],rnrn    "paths": {rnrn        "/v4/address/validate": {rnrn            "get": {rnrn                "summary": "Validate an Email Address",rnrn                "produces": [rnrn                    "application/json"rnrn                ],rnrn                "parameters": [rnrn                    {rnrn                        "in": "query",rnrn                        "name": "address",rnrn                        "description": "Email Address to be Verified",rnrn                        "required": true,rnrn                        "type": "string"rnrn                    }rnrn                ],rnrn                "responses": {rnrn                    "200": {rnrn                        "description": "Result of the Email Address Validation",rnrn                        "schema": {rnrn                            "$ref": "#/definitions/validationResponse"rnrn                        }rnrn                    }rnrn                }rnrn            }rnrn        }rnrn    },rnrn    "definitions" : {rnrn        "validationResponse" : {rnrn            "properties": {rnrn                "result": {rnrn                    "description": "result",rnrn                    "type": "string"rnrn                }rnrn            }rnrn        }rnrn    }rnrn}
                                
                            

Votre service externe devrait ressembler à ceci :

5. Sélectionnez l’opération getv4AddressValidate et cliquez sur Suivant.

6. Cliquez sur Terminé.

Maintenant que nous avons boosté Salesforce avec Mailgun, nous allons créer un Screen Flow (flux d’écran) pour utiliser l’API de validation des emails de Mailgun dans Salesforce.

1. Dans la configuration de Salesforce, allez dans Flux > Nouveau flux.

2. Sélectionnez Flux d’écran et cliquez sur Créer.

3. Le flux sera simplement composé de trois éléments : un élément d’écran, un élément d’action et un autre élément d’écran

4. Ajoutez le premier élément d’écran :

Le nom de l’élément peut être « Email Address Entry » et cet élément ne comportera qu’un seul champ de type Texte. Nommez ce champ « Email Address », comme illustré ci-dessous.

5. Ajoutez un élément d’action en dessous de l’élément d’écran. Dans le flux, créez une nouvelle ressource en cliquant sur le bouton « Nouvelle ressource ». Ajoutez ces valeurs de champ à la nouvelle ressource et enregistrez-la :

• Resource Type = Variable
• API Name = Mailgun External Service
• Data Type = Défini par Apex
• Apex Class = ExternalService__MailgunEmailVerificationsExternalService_validationResponse (ou le nom que vous avez donné à votre service externe à l’étape 3 ci-dessus)
• « Disponible en entrée » et « Disponible en sortie » doivent tous deux être définis sur True

6. Ajoutez un élément d’action au flux dont le type est Service externe. Le champ Action doit correspondre à votre service externe, et les valeurs d’entrée doivent simplement être l’adresse email (Email Address) de l’élément d’écran 1 ci-dessus. Assurez-vous de sélectionner Avancé > Sorties et de saisir la variable définie par Apex que vous avez créée ci-dessus, appelée MailgunExternalServices. Votre élément d’action devrait ressembler à ceci :

7. Ajoutez maintenant votre dernier élément d’écran. Il comportera uniquement un champ de type Texte d’affichage (Display Text) et affichera le résultat de l’action de l’appel au service externe ci-dessus.  L’écran devrait ressembler à ceci (notez que la valeur de sortie {!MailgunExternalService.result} se trouve au-dessus du texte d’affichage en cliquant sur Insérer une ressource, puis en sélectionnant la sortie de votre variable de service externe, comme illustré ci-dessous) :

Et c’est tout ! Voyons maintenant cela en action.

Vous avez intégré avec succès l’API de Mailgun à votre organisation Salesforce. Voyons comment tout cela fonctionne.

Pour tester le flux que vous avez créé ci-dessus :

1. Cliquez sur le bouton Exécuter (Run) sur le flux.
2. Ensuite, cliquez sur Saisir une adresse email (Enter any email address).
3. Saisissez une adresse email.
4. Cliquez sur Suivant.

Vous devriez obtenir un résultat de l’API de Mailgun indiquant si l’adresse email que vous avez saisie est une adresse email livrable ou non livrable. Vous voulez en savoir plus ? Regardez cette vidéo pour voir à quoi ressemble l’utilisation de ce flux.

Nous avons passé en revue quelques méthodes pour vérifier votre adresse email avec notre interface utilisateur et notre API de validation des emails de Mailgun. Nous vous avons également donné des conseils pour intégrer notre API à des clients externes comme Salesforce.

À présent, vous devriez être sur la bonne voie pour vérifier la validité de vos adresses email en temps réel et pour commencer vos envois ! Vous avez encore des questions ? N’hésitez pas à nous contacter !

Auteur·trice: Danny Carranza Product Manager at Sinch Mailgun

Co-auteur·trice: Peter Trinder Peter Trinder is a Sr. Product Manager at Sinch Mailgun. He works to build and implement product strategies, and provides guidance for our roadmap and operations. He writes about new features and how to use and understand them to improve performance.