Aller au contenu principal

Questions fréquentes

Résultats​

Pourquoi mon adresse ressort unknown ?​

Le serveur de messagerie n'a pas permis de conclure. La cause est dans features.smtp.reasonCode :

  • ACCEPT_ALL_DOMAIN : le domaine accepte n'importe quelle adresse, l'existence de la boîte ne peut pas être prouvée ;
  • GREYLISTED : le serveur demande de réessayer plus tard ;
  • TIMEOUT, NETWORK_ERROR_ETIMEDOUT : le serveur a été trop lent ou injoignable ;
  • SMTP_INCONCLUSIVE : le serveur a répondu sans permettre de trancher (refus temporaire, réponse ambiguë).

Un unknown n'est jamais facturé. Revalidez plus tard pour le greylisting, les délais et SMTP_INCONCLUSIVE ; pour un domaine accept-all, le résultat ne changera pas. Voir Verdicts et score.

Un domaine accept-all, c'est valide ou pas ?​

Ni l'un ni l'autre : le verdict est unknown, avec features.catchAll et l'avertissement CATCH_ALL_DOMAIN. Beaucoup d'entreprises configurent ainsi leur messagerie, et l'adresse est souvent bonne, mais rien ne le prouve. Si vous devez trancher, une politique peut refuser les accept-all (reject_catch_all).

J'obtiens valid alors que la boîte n'existe pas​

Vérifiez que la clé a bien le SMTP activé. Sans SMTP, valid signifie seulement « adresse bien formée et domaine joignable » : l'existence de la boîte n'est pas testée. features.smtp est absent de la réponse quand le SMTP est désactivé.

Un verdict me surprend : que transmettre au support ?​

La référence debug_ref de la réponse (par exemple YWC-7KQ2M9AB) et l'adresse vérifiée, à [email protected]. Avec elle, nous retrouvons le détail du traitement de cette adresse pendant 90 jours. Pour un traitement par lots, indiquez le nom du fichier et l'adresse. Voir la référence support.

J'envoie "smtp": true mais le SMTP ne se fait pas​

Avec une clé API, le champ smtp du corps est ignoré : c'est la configuration de la clé qui décide. Activez le SMTP sur la clé dans Clés API, ou créez une seconde clé avec SMTP. Voir Authentification.

Le score est bas alors que le verdict est valid​

Un valid a toujours un score d'au moins 70 : en dessous, il devient risky. Un score de 70 à 89 signale un point d'attention mineur (compte générique, domaine peu configuré…) que warnings et features détaillent.

Pourquoi une adresse jetable est-elle risky et pas invalid ?​

Parce qu'elle reçoit bien le courrier, pour l'instant. Le verdict invalid est réservé aux adresses qui ne recevront rien. Pour refuser les jetables, testez disposable === true ou utilisez la règle reject_disposable d'une politique.

Pourquoi une adresse noreply est-elle risky ?​

Parce qu'une boîte comme noreply@ ou ne-pas-repondre@ n'est lue par personne : qu'elle existe ou que le serveur n'ait pas permis de conclure, elle n'a pas sa place dans une liste d'envoi. Une boîte refusée par le serveur reste invalid. Le signal est dans features.noReply et l'avertissement NO_REPLY ; pour la refuser, utilisez la règle reject_no_reply d'une politique. Voir Les contrôles.

Quelle différence entre faute de frappe et domaine piège ?​

La faute de frappe (typoDomain) est une erreur de l'utilisateur : gmial.com au lieu de gmail.com. Le domaine piège (typosquat) est un domaine réellement enregistré pour imiter un fournisseur et capter le courrier qui lui était destiné : le message arrive, mais chez quelqu'un d'autre. Les deux peuvent se cumuler. Voir Anatomie de la réponse.

Intégration​

Puis-je appeler l'API depuis le navigateur ?​

Pas avec une clé : elle serait visible par tous les visiteurs. Utilisez le widget, conçu pour ce cas, ou faites transiter l'appel par votre serveur. Le widget couvre aussi l'autocomplétion du domaine et la détection de faute de frappe, sans clé dans la page.

Puis-je valider une liste via l'API ?​

Pas en REST : le traitement par lots se lance depuis le tableau de bord. Un agent peut en revanche lancer et suivre un lot de 5 000 adresses avec l'outil validate_emails_batch du serveur MCP, avec une clé API. Pour un flux continu, appelez POST /v2/email/validate adresse par adresse en respectant la limite de 100 requêtes par minute.

Puis-je vérifier mes contacts Brevo sans export ?​

Oui, avec le connecteur Brevo : YesWeCheck lit la liste choisie, la vérifie comme un traitement par lots et écrit le verdict sur chaque contact. Il peut aussi vérifier automatiquement chaque nouveau contact. Mailjet, Klaviyo et Systeme.io sont aussi couverts (voir ci-dessous) ; voir les connecteurs.

Puis-je vérifier les emails de mes contacts HubSpot ?​

Oui, avec le connecteur HubSpot et une clé de service HubSpot : YesWeCheck vérifie une liste ou tous vos contacts, écrit le verdict dans quatre propriétés ywc_* (groupe YesWeCheck) et peut vérifier automatiquement les nouveaux contacts des listes que vous surveillez. Vous pouvez aussi vérifier un contact à l'unité depuis l'espace client.

Puis-je vérifier les emails de mes personnes Pipedrive ?​

Oui, avec le connecteur Pipedrive et votre jeton API Pipedrive : YesWeCheck vérifie toutes vos personnes ou un filtre, écrit le verdict dans quatre champs personnalisés YWC et peut vérifier automatiquement chaque nouvelle personne. Seule l'adresse principale de chaque personne est vérifiée. Vous pouvez aussi vérifier une personne à l'unité depuis l'espace client.

Puis-je nettoyer mes audiences Mailchimp ?​

Oui, avec le connecteur Mailchimp et une clé API Mailchimp : YesWeCheck vérifie une audience, un segment ou un tag, écrit le verdict dans quatre champs de fusion YWC_* (ou en tags, au choix) et peut vérifier automatiquement les nouveaux inscrits. Les adresses invalides peuvent être taguées, désinscrites ou archivées ; Mailchimp ne compte plus les contacts archivés dans votre forfait.

Puis-je nettoyer mes listes Mailjet ?​

Oui, avec le connecteur Mailjet, votre clé API et votre clé secrète Mailjet : YesWeCheck vérifie tous vos contacts ou une liste, écrit le verdict dans quatre propriétés de contact ywc_* et peut vérifier automatiquement les nouveaux contacts et les ajouts à vos listes. Les adresses invalides peuvent être regroupées dans une liste, désinscrites de la liste nettoyée ou exclues des campagnes. Chaque sous-compte Mailjet se connecte avec ses propres clés.

Puis-je nettoyer mes listes et segments Klaviyo ?​

Oui, avec le connecteur Klaviyo et une clé API privée : YesWeCheck vérifie tous vos profils, une liste ou un segment, écrit le verdict dans quatre propriétés de profil ywc_* et peut vérifier automatiquement les nouveaux profils et les entrées dans vos listes et segments. Les adresses invalides peuvent être regroupées dans une liste, retirées de la liste nettoyée ou supprimées au sens Klaviyo : elles ne reçoivent plus d'email marketing et ne comptent plus dans les profils actifs de votre forfait.

Puis-je vérifier mes contacts Systeme.io ?​

Oui, avec le connecteur Systeme.io et une clé API publique : YesWeCheck vérifie tous vos contacts ou ceux qui portent un tag, écrit le verdict dans quatre champs de contact YWC et peut vérifier automatiquement les nouveaux contacts et ceux qui reçoivent un tag surveillé. Les adresses invalides peuvent recevoir un tag de quarantaine ; une règle d'automatisation Systeme.io déclenchée par ce tag les désinscrit de vos campagnes. Aucun contact n'est supprimé.

Puis-je nettoyer mes contacts Positive User (ex-Sarbacane) ?​

Oui, avec le connecteur Positive User, l'adresse de votre espace User.com et une clé d'API publique : YesWeCheck vérifie tous vos contacts, une liste, un tag ou un segment, écrit le verdict dans quatre attributs YWC et peut vérifier automatiquement les nouveaux contacts. Les adresses invalides peuvent être taguées, désinscrites ou bannies. L'ancienne interface Sarbacane, à l'API distincte, n'est pas couverte.

Puis-je vérifier une liste d'emails dans Google Sheets ?​

Oui, avec le connecteur Google Sheets : connectez votre compte Google, choisissez la feuille et la colonne des emails. YesWeCheck n'accède qu'aux fichiers que vous choisissez, vérifie les adresses comme un traitement par lots et écrit le verdict dans quatre colonnes ajoutées à droite de vos données. Les lignes ajoutées ensuite peuvent être vérifiées automatiquement.

Puis-je utiliser YesWeCheck depuis ChatGPT ou Claude ?​

Oui. Ajoutez le serveur MCP https://api.yeswecheck.fr/mcp comme connecteur dans Claude, ChatGPT, Le Chat, Claude Code, Cursor ou VS Code, puis autorisez l'accès sur la page YesWeCheck qui s'ouvre. L'assistant vérifie des adresses, des listes, et trouve l'email professionnel d'une personne (20 recherches par jour), avec vos réglages et vos crédits.

Existe-t-il un bac à sable ?​

Non. Pour tester sans dépenser, utilisez une clé sans SMTP : tous les autres contrôles sont gratuits. Les clés ywc_test_ fonctionnent exactement comme les clés ywc_live_, elles ne sont pas gratuites.

Puis-je consulter mon solde par API ?​

Pas en REST. Lisez metadata.credits.remaining dans les réponses de validation avec SMTP, et activez les alertes de solde dans Paramètres → Notifications. Un agent connecté au serveur MCP lit le solde avec l'outil get_credits.

Y a-t-il des SDK ?​

Pas encore. L'API se résume à un appel HTTP JSON ; les exemples de cette documentation couvrent cURL, Node.js, Python et PHP, et la Console API du tableau de bord génère le code d'appel dans neuf langages. La spécification OpenAPI permet aussi de générer un client.

Comment savoir si l'API est disponible ?​

status.yeswecheck.fr affiche l'état des services et l'historique des incidents. Pour vos propres sondes, GET https://api.yeswecheck.fr/health répond sans authentification.

Sécurité et données​

Ma clé a fuité, que faire ?​

Révoquez-la immédiatement dans Clés API : elle est refusée dès l'appel suivant. Créez-en une nouvelle, ou faites tourner la clé (nouveau secret, même configuration) sans période de grâce. Ajoutez ensuite un plafond de crédits et une restriction d'IP. Voir Authentification.

Envoyez-vous un email à l'adresse vérifiée ?​

Non. La vérification SMTP s'arrête avant tout envoi : aucun message n'arrive dans la boîte.

Où sont hébergées les données ?​

Données hébergées en France, par OVHcloud. L'infrastructure, opérée par OVHcloud et certifiée ISO/IEC 27001, bénéficie d'une protection anti-DDoS et d'une sauvegarde automatique quotidienne. Les adresses conservées (historique du tableau de bord, résultats de traitements par lots) sont chiffrées. Les résultats détaillés d'un traitement par lots sont supprimés 7 jours après sa fin, ou 30 jours si votre organisation le choisit dans Paramètres → Préférences, et un compte peut être supprimé depuis Paramètres → Compte. Voir aussi la page Sécurité.