Traitement par lots

Pour nettoyer une liste existante (base clients, fichier de prospects, abonnés d'une newsletter), importez-la dans Traitement par lot du tableau de bord. Les adresses sont validées avec les mêmes contrôles et les mêmes règles de verdict que l'API.

Disponible depuis le tableau de bord

Le traitement par lots se pilote depuis app.yeswecheck.fr. Ses routes HTTP n'acceptent qu'une session du tableau de bord et pas de clé API : elles ne font pas partie de l'API publique. Pour valider des adresses au fil de l'eau depuis un serveur, utilisez POST /v2/email/validate.

Préparer le fichier

Contrainte	Valeur
Formats	CSV ou texte (.csv, .txt), une adresse par ligne pour un fichier texte
Séparateur CSV	Détecté automatiquement (,, ;, tabulation)
Taille maximale	15 Mo
Lignes	500 000 au plus
Jobs simultanés	Un traitement actif à la fois par organisation

Un classeur Excel s'exporte en CSV avant l'import. Les autres colonnes du fichier (identifiant, nom, société…) sont conservées et permettent de rapprocher les résultats de votre base.

Lancer un traitement

1. Importer : un aperçu affiche les premières lignes et la colonne d'adresses détectée. Corrigez le choix de colonne et la présence d'une ligne d'en-tête si besoin.
2. Choisir les options (tableau ci-dessous).
3. Suivre : la progression, les compteurs par verdict et le temps restant estimé se mettent à jour en direct. Vous pouvez quitter la page, mettre en pause, reprendre ou annuler.
4. Exporter les résultats et le rapport PDF.

Option	Défaut	Effet
Vérification SMTP	activée	Confirme l'existence des boîtes ; 1 crédit par adresse conclusive
Dédoublonnage	activé	Une adresse présente plusieurs fois n'est validée et facturée qu'une fois
Seconde passe	désactivée	Revalide plus tard les adresses restées unknown (greylisting, serveurs lents) ; allonge le traitement
Pays de référence	aucun	Pays utilisé pour l'âge présumé quand la liste est mono-pays sur des domaines génériques
Mode audit	désactivé	Rapport de qualité sur un échantillon, sans résultats ligne à ligne (voir plus bas)
Libellé	—	Nom du traitement dans l'historique

Déroulement

Phase	Ce qui se passe
Pré-analyse	Syntaxe, DNS, jetables, fautes de frappe, domaines pièges… pour toutes les lignes. Rapide.
SMTP	Dialogue avec les serveurs de messagerie, réparti par domaine et cadencé pour respecter chaque fournisseur. C'est la phase la plus longue.
Seconde passe	Si activée : nouvelle tentative sur les unknown, après un délai.

La durée dépend surtout de la part de grands fournisseurs (Gmail, Microsoft, Orange…) qui imposent un rythme. Comptez de quelques minutes pour une petite liste sans SMTP à plusieurs heures pour des centaines de milliers d'adresses avec SMTP.

Crédits

Mêmes règles que l'API : 1 crédit par adresse validée avec SMTP dont le verdict final n'est pas unknown. Les unknown sont remboursés à la clôture du traitement. Si le solde s'épuise en cours de route, le traitement continue sans SMTP pour les lignes restantes au lieu d'échouer, et le rapport le signale. Voir Crédits.

Mode audit

Le mode audit répond à « que vaut ma liste ? » avant de payer le traitement complet : la pré-analyse porte sur toute la liste, le SMTP sur un échantillon représentatif, et le rapport estime la délivrabilité, avec une marge d'erreur, par fournisseur.

Les résultats ligne à ligne restent verrouillés. Vous pouvez débloquer le traitement complet dans les 30 jours qui suivent l'audit : les crédits sont alors débités et les résultats deviennent exportables.

Exporter

L'export se configure avant d'être généré :

Réglage	Choix
Format	CSV, Excel (.xlsx), texte (une adresse par ligne), JSON, NDJSON
Contenu	Complet (toutes les colonnes), simplifié (row_id, email, result, notes, correction_typo) ou personnalisé
Verdicts	Toutes les lignes, ou seulement certains verdicts (par exemple valid seul pour une campagne)
Découpage	Un fichier, ou un fichier par verdict
Colonnes personnalisées	Choix, ordre et renommage des colonnes (row_id, email et result sont toujours inclus)
Options CSV	Séparateur (virgule, point-virgule, tabulation), encodage UTF-8 avec ou sans BOM, booléens true/false ou 1/0, dates ISO ou format local

Les gros exports sont préparés en arrière-plan : un lien de téléchargement, valable 48 heures, vous est envoyé par email. Le rapport PDF synthétise la qualité de la liste : répartition des verdicts, causes de rejet, fournisseurs, recommandations.

Colonnes de l'export complet

Colonne	Contenu
row_id	Numéro de la ligne dans votre fichier
email	Adresse telle qu'importée
result	Verdict : valid, risky, invalid, unknown
score	Score de 0 à 100
notes	Motif lisible du verdict, avec la faute de frappe ou le domaine piège en complément
smtp_result	Résultat du SMTP : valid, invalid, unknown
smtp_reason	Code de raison SMTP (MAILBOX_NOT_FOUND, ACCEPT_ALL_DOMAIN…)
syntax_valid · dns_valid	Syntaxe correcte · domaine joignable
disposable	Adresse jetable
malicious_domain	Domaine malveillant
role_account	Compte générique
profanity	Terme injurieux
random_string	Partie locale aléatoire
is_alias	Sous-adressage
typo_domain	Faute de frappe probable dans le domaine
typo_suggestion	Domaine suggéré (vide si le domaine voulu ne reçoit plus de courrier)
correction_typo	Adresse corrigée vérifiée délivrable (avec SMTP uniquement)
typosquat	Domaine piège
free_provider · business_email	Fournisseur grand public · adresse professionnelle
whitelisted · blacklisted	Sur votre liste blanche · noire
first_name · last_name · gender	Prénom, nom, genre déduits
presumed_age · age_range	Âge présumé, tranche d'âge
validated_at	Date de validation (ISO 8601)
processing_ms	Durée de traitement de la ligne
aliasing_note	Alerte d'usage massif d'alias sur une même boîte

Conservation des résultats

Les résultats détaillés sont conservés 7 jours après la fin du traitement, puis supprimés. Des rappels sont envoyés par email avant la suppression. Exportez ce dont vous avez besoin dans ce délai. Le téléchargement des exports peut être protégé par un code PIN dans Paramètres → Sécurité.