Documentation de CaptainVerify

Vérification email et numéro mobile : Pour bien commencer

CaptainVerify vous permet de vérifier la validité de vos emails et numéros mobiles en les envoyant sous forme de liste ou en utilisant l'API directement dans votre application. Voici les étapes pour bien commencer :

Étape 1 : Créer un compte gratuit Captain Verify

CaptainVerify vous propose la vérification de 100 emails gratuitement pour l'ouverture du compte (sur demande). 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 et numéros mobiles

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


Comment Captain Verify fonctionne

Captain Verify 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. Captain Verify 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 nous assurons en amont l'existence du domaine, s'il y a un serveur SMTP associé à celui-ci, et bien plus encore.

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

La vérification de numéro mobile : Captain Verify vérifie la validité de vos numéros directement auprès des compagnie de télécommunication (MNO et MVNO). Même en cas de portabilité ou d'itinérance en envoyant une requête de type HLR Lookup sur le réseau mobile. Home Location Register (HLR) permet d'obtenir les codes MCC & MNC (premiers chiffres du n° IMSI) intégrés à leur carte SIM et d'identifier un numéro de téléphone portable (si il est valide ou non, à quel opérateur il est rattaché et le roaming).


Terminologie : Statut de l'email

Résultat Description

Valide

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

Invalide

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

Inconnu

Le serveur distant du fournisseur n'a pas répondu à temps.
Cela signifie que nous n'avons pas reçu de réponse claire pour des raisons techniques indépendantes de notre volonté (lenteur/mauvaise configuration du serveur, une protection antispam pour que la verification passe en "inconnu".

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 contact@ ou info@ ou posmaster@.
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 à 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.

Terminologie : Statut du numéro mobile

Résultat Description

Valide

Le numéro mobile est valide, vous pouvez envoyer des sms sans problème.

Invalide

Le numéro mobile est invalide (inactif, désactivé, jamais enregistré).

Inconnu

Le numéro mobile n'a pas pu être identifié. Le numéro n'est pas au bon format (336XXXXXXXX ou 337XXXXXXXX), ou il s'agit d'un numéro de téléphone fixe.

Sécurité et confidentialité

Vos emails sont sensibles, vous appartiennent, ils doivent rester privés et sécurisés. CaptainVerify ne partagera ou ne louera jamais ces informations à des tiers. Toutes les informations qui passent par CaptainVerify 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, 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 ou un numéro mobile par ligne,
  • la premiere ligne doit contenir un champ nommé (mais c'est optionnel),
  • les adresses emails doivent être dans la même colonne.

exemple csv

Vous ne devez pas rajouter de colonne supplémentaire en plus de la colonne email/numéro mobile, le fichier vous sera restitué avec en plus les informations de validité de l'email. Pour envoyer votre fichier, cliquez sur “Parcourir” ou simplement faites glisser le fichier dans le cadre prévu à 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 ou des numéros mobiles aux format international (336XXXXXXXX ou 337XXXXXXXX). 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 à nouveau la vérification.

Start Verification

É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, les colonnes CAPTAIN_VERIFY_STATUT, CAPTAIN_VERIFY_GRATUIT, CAPTAIN_VERIFY_ROLE, CAPTAIN_VERIFY_JETABLE, CAPTAIN_VERIFY_RISQUE sont ajoutées. Attention, votre liste est cryptée et protégée par un mot de passe, celui-ci s'affiche dans votre dashboard. Une fois que vous avez récupéré votre liste, nous vous conseillons de l'effacer du dashboard.

download list

verify list


API

Avec l'API de CaptainVerify, 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.


Clé API

Un compte est nécessaire pour générer la clé pour l'API, c'est ce qui vous donnera accès au service.


La requête

Pour faire une demande à l'API, appelez simplement le protocole GET à cette URL:

https://captainverify.com/api/v1/verify?email=john.doe@gmail.com&apikey=API_KEY

Remplacez john.doe@gmail.com par votre email pour vérifier


La réponse

Une table json sera renvoyée avec ces variables:

Variables Valeur possible

success

true, false
Si l'authentification a échoué, l'épuisement de vos crédits

message

default : null
Lorsque le succès est faux, un message d'erreur sera envoyé.

credits

Crédits disponibles sur votre compte

email

L'email que vous souhaitez vérifier

email_normalized

L'email a normalisé, l'élimination des étiquettes pour gmail ... support+test@gmail.com sera support@gmail.com

role

true, false
Si l'utilisateur du courrier électronique a un rôle, ex: support@exemple.com

free

true, false
Si le fournisseur de messagerie est gratuit, ex : Gmail.com

disposable

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

risky

true, false
Si le fournisseur de courrier électronique lutte contre le spam et n'est pas un utilisateur réel

did_you_mean

default : null
Si par exemple, le courrier électronique est john.doe@gmil.com, l'API vous enverra une proposition comme john.doe@gmail.com

status

valid, invalid, unknown
Le statut de l'email. si tous vos crédits ont été épuisés, le statut inconnu sera toujours retourné, pour ne pas bloquer votre application.

Vérifier la validité de vos emails. Inscrivez-vous dès maintenant