Pour bien commencer

HardBounceCleaner vous permet de vérifier la validité de vos emails en les envoyant sous forme de liste ou en utilisant l'API temps réel directement dans votre application.  Voici les étapes pour bien commencer :

Étape 1 : Créer un compte gratuit HardBounceCleaner

HardBounceCleaner vous propose la vérification de 100 emails gratuitement pour l'ouverture du compte. Si vous avez besoin de plus, retrouvez sur la page d'accueil notre grille de prix.

Cliquez ici pour vous créer votre compte gratuit.

Étape 2 : Valider vos emails

Vous êtes maintenant prêt à télécharger une liste (fichier csv ou txt) d'emails à vérifier et/ou à intégrer l'API temps réel. N'hésitez pas a envoyer au support la moindre de vos questions.

Comment HardBounceCleaner fonctionne

HardBounceCleaner va vérifier la validité de vos emails en utilisant le protocole SMTP. C'est celui-là même que vous utilisez sans forcément le savoir lorsque vous envoyez vos emails. HardBounceCleaner n'envoie pas d'email pour faire cette vérification, mais va interroger étape par étape le système distant, par exemple Gmail. Qui va nous dire si l'email demandé existe bel et bien. En plus de cette vérification finale, nous vérifions en amont l'existence du domaine, s'il y a un serveur SMTP associé à ce domaine, et bien plus encore.

Même si cette approche peut sembler simple, c'est en fait étonnamment complexe des que l'on commence à vouloir vérifier plus de 10 emails. Les fournisseurs d'emails mettent en place énormément de mesures pour être sur que la demande est légitime. C'est pour cela que beaucoup d'entreprises utilisent notre système et profitent de notre expérience.

Terminologie : Statut de l'email

Résultat Description

Valide

L'email est valide, vous pouvez l'envoyer sans problèmes

Invalide

L'email est invalide, supprimez le de votre base de données, ou refusez l'inscription si vous utilisez l'API temps réel

Inconnu

Le serveur distant du fournisseur n'a pas répondu à temps, ce qui signifie que nous n'avons pas reçu de réponse claire. Nous vous conseillons de ne pas envoyer ce genre d'emails

Qualification de l'email

Résultat Description

Gratuit

Le fournisseur est gratuit (Gmail, Yahoo, etc…) c'est bon signe si votre base de données est BtoC

Rôle

L'utilisateur de cet email a un rôle, par exemple [email protected] ou [email protected] ou [email protected] Ce qui signifie que cet email n'est pas adressé a quelqu'un de précis, évitez d'envoyer ce genre d'emails.

Jetable

L'email est valide, mais jetable après une courte période il ne sera plus possible de contacter l'utilisateur.

Risqué

Cet email semble appartenir a un organisme qui traque le Spam, c'est très risqué de l'envoyer et aucune personne réel n'est derrière cet email

Sécurité et confidentialité

Vos emails sont sensibles, vous appartiennent et doivent restés, privés et sécurisés. HardBounceCleaner ne partagera ou ne louera jamais ces informations à des tiers. Toutes les informations qui passent par HardBounceCleaner sont cryptées via SSL, c'est ce même protocole qui est utilisé pour sécuriser les transactions financières.

Lors d'une vérification par liste, une fois votre fichier téléchargé et validé, il sera crypté et un mot de passe unique sera demandé pour pouvoir l'ouvrir. De la même manière, lors de l'utilisation de l'API temps réel,  les emails que vous voulez vérifier passent par le protocole https (SSL) et ne sont donc pas lisible en clair sur le réseau.

Nettoyer une liste

Étape 1 : Importer la liste

Votre fichier qui contient les emails doit être au format CSV idéalement avec comme séparateur de colonne la virgule et comme encodage utf8. Assurez-vous d'avoir un fichier (csv ou txt) qui respecte les conditions suivantes :

  • la liste de diffusion doit contenir un email par ligne
  • la premiere ligne doit contenir un champ nommé mais c'est optionnel
  • les adresses emails doivent être dans la même colonne

Vous pouvez avoir des colonnes supplémentaires en plus de la colonne email, le fichier vous sera restitué avec en plus les informations de validité de l'email. Pour envoyer votre fichier, cliquez sur “Parcourir” ou simplement faitee glisser le fichier dans le cadre prévue à cet effet.

Étape 2 : Contrôle du format

Un contrôle de conformité va ensuite être effectué sur votre fichier pour détecter la présence des emails et voir si le format est correct. Une fois cette étape passée, vous serez prévenu par email et vous pouvez alors commencer la vérification du fichier.

Étape 3 : Lancement de la vérification

Pour lancer la vérification du fichier vous devez cliquer sur Démarrer, des que la vérification est terminée un email vous est envoyé. Si jamais vous n'avez pas assez de crédits pour vérifier entièrement le fichier, le traitement s'arrêtera lorsque vos crédits seront a 0. Vous pourrez alors acheter les crédits manquant et lancer a nouveau la vérification.

Étape 4 : Récupération de la liste

Une fois la vérification terminée vous pouvez télécharger le fichier avec différentes informations, soit votre liste complète ou alors uniquement la liste des emails valides, invalides, ou ceux dont le statut est inconnu. Pour chaque ligne, sont ajoutées les colonnes: StatutGratuitRôle JetableRisqué Attention, votre liste est cryptée et protégée par un mot de passe, celui-ci s'affichera lors du clique sur le bouton “Télécharger”. Une fois que vous avez récupéré votre liste, nous vous conseillons de l'effacer de la queue.

API temps réel

Avec l'API temps réel HardBounceCleaner, vous pouvez intégrer la vérification d'email dans vos propres applications. Cela vous permet par exemple de vérifier si vos utilisateurs ont bien renseigné un email correct avant même l'inscription.

Les Clés API

Un compte est nécessaire pour générer des clés pour l'API, ce sont elles qui vous donneront accès au service. Nous vous conseillons de créer autant de clés que de sources, par exemple si vous avez  2 sites internet, créez 2 clés avec ces 2 noms de domaine. Ajoutez bien le nom de domaine ou l'adresse ip utilisée pour effectuer une requête sur l'API. Toutes les semaines nous allons generer pour vous un fichier proteger par cles API, contenant la liste des emails vérifiée par ce biais. Vous pourrez alors télécharger ces listes, et les effacer ensuite.

La requête

Pour effectuer une requête vers l'API, il suffit d'appeler avec le protocole GET cette url :
https://www.hardbouncecleaner.com/api/v1/[email protected]&timeout=10&language=fr

En passant a la place de [email protected] l'email à vérifier, et en ajoutant une ligne d'entête X-HardBounceCleaner-Key avec la clé de l'API Vous retrouverez sur la page API des exemples dans les langages suivant :  cURL, PHP, Node.js, jQuery, Python, Ruby, Java, Objective-C, .NET, Windows 8

La réponse

Un tableau Json vous sera retourné avec ces variables :

Variable Valeur possible

success

true, false
En cas de problème d'authentification, d'épuisement de vos crédits, success renverra false

error_message

null par défaut
Lorsque success est false un message d'erreur dans votre langue vous sera envoyé.

email

L'email que vous souhaitez vérifier

role

true, false
Si l'utilisateur de l'email a un role, ex [email protected]

free

true, false
Si le fournisseur de l'email est gratuit, ex gmail.com

disposable

true, false
Si le fournisseur de l'email est jetable, c'est dire si l'email a une courte duree de vie

risky

true, false
Si le fournisseur de l'email est un service de lutte contre le Spam, et non pas un utilisateur reel

did_you_mean

null par défaut
Si par exemple l'email à verifier est [email protected] l'API vous enverra comme proposition [email protected]

status

valid, invalid, unknown
Le statut de l'email, si par exemple tout vos crédits ont été épuisé le statut unknown vous sera alors toujours renvoyé, pour ne pas bloquer votre application.