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 :
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.
Vous êtes maintenant prêt à importer une liste (fichier csv ou txt) d'emails à vérifier et/ou à intégrer l'API. N'hésitez pas à envoyer un message au support si vous avez des questions.
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). Numéro mobile Français uniquement.
| 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. |
| 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@. |
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. |
| Détails | Description |
|---|---|
error |
Erreur : le serveur dit que la vérification a échoué |
smtp_error |
Erreur smtp : le serveur nous a signalé une erreur interne du serveur distant |
smtp_protocol |
La session smtp a été fermée avant la vérification de l'email |
unknown_email |
La vérification de l'email a échouer et l'email semble ne pas exiter |
attempt_rejected |
Rejeté : échec de la vérification |
relay_error |
Erreur de relais : échec de la vérification |
antispam_system |
Une technologie antispam bloque les progrès de la vérification |
email_disabled |
L'email est désactivé : suspendu / désactivé / limité |
domain_error |
Le serveur de messagerie du domaine n'est pas installé ou est incorrect |
ok_for_all |
Ok pour tout : le serveur de messagerie distant accepte n'importe quel email |
dead_server |
Le serveur de messagerie n'est pas fonctionnel |
syntax_error |
Erreur de syntaxe dans l'adresse électronique |
unknown |
Echec de la vérification du courrier électronique, mais aucune information sur les raisons |
| 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. |
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.
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 :
Vous ne devez pas rajouter de colonne supplémentaire en plus de la colonne email ou 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.
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 Français aux format international (336XXXXXXXX ou 337XXXXXXXX). Une fois cette étape passée, vous pouvez alors commencer la vérification du fichier.
Pour lancer la vérification du fichier vous devez cliquer sur "Démarrer". 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.
Une fois la vérification terminée vous pouvez télécharger le fichier XLSX avec différentes informations, soit votre liste complète ou alors uniquement la liste des emails valides. Pour chaque ligne, les colonnes Statut, Free, Disposable, Risky, Role, Did_you_mean et Details 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.
Votre fichier sera comme dans l'exemple ci-dessous.
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.
Un compte est nécessaire pour générer la clé pour l'API, c'est ce qui vous donnera accès au service.
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
Une table json sera renvoyée avec ces variables:
| Variables | Valeur possible |
|---|---|
success |
true, false |
message |
default : null |
credits |
Crédits disponibles sur votre compte |
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 |
free |
true, false |
disposable |
true, false |
risky |
true, false |
did_you_mean |
default : null |
result |
valid, invalid, unknown |
details |
null, error, smtp_error, antispam_system, email_disable, ok_for_all... |