Outils sans code

YesWeCheck n'a pas encore d'intégration native dans les outils d'automatisation, mais tous savent appeler une API HTTP. Le principe est le même partout.

Préparer une clé dédiée

Créez une clé spécifique à l'outil d'automatisation, avec :

• le SMTP activé seulement si vous voulez confirmer les boîtes (1 crédit par vérification conclusive) ;
• un plafond de crédits journalier, pour qu'une boucle mal réglée ne vide pas votre solde ;
• le contrôle network désactivé : l'IP analysée serait celle de l'outil, pas celle du contact.

N'ajoutez pas de restriction d'origine (allowedDomains) : ces outils n'envoient pas d'en-tête Origin et seraient refusés.

Le module HTTP

Paramètre	Valeur
Méthode	POST
URL	https://api.yeswecheck.fr/v2/email/validate
En-tête	Authorization = Bearer ywc_live_…
En-tête	Content-Type = application/json
Corps (JSON)	{"email": "<champ email de l'étape précédente>"}
Délai	30 secondes si la clé a le SMTP

Puis filtrez sur result : valid pour continuer, invalid pour écarter, et décidez pour risky et unknown.

Zapier

Action Webhooks by Zapier → Custom Request, avec les paramètres ci-dessus. Le champ Data reçoit le JSON. Ajoutez ensuite une étape Filter sur result.

Make

Module HTTP → Make a request, corps de type Raw, contenu JSON (application/json), et cochez Parse response pour accéder à result et score dans les modules suivants.

n8n

Nœud HTTP Request : authentification Generic Credential Type → Header Auth, nom Authorization, valeur Bearer ywc_live_…. Corps en JSON avec l'expression {{ $json.email }}.

Écrire le verdict dans un CRM

Stockez au moins ces trois valeurs sur la fiche contact :

Propriété	Source
Verdict	result
Score	score
Date de validation	metadata.timestamp

Exemple en Python avec HubSpot :

import os
import requests

def enrich_contact(contact_id: str, email: str) -> None:
    verdict = requests.post(
        "https://api.yeswecheck.fr/v2/email/validate",
        headers={"Authorization": f"Bearer {os.environ['YWC_API_KEY']}"},
        json={"email": email},
        timeout=30,
    ).json()

    requests.patch(
        f"https://api.hubapi.com/crm/v3/objects/contacts/{contact_id}",
        headers={"Authorization": f"Bearer {os.environ['HUBSPOT_TOKEN']}"},
        json={"properties": {
            "ywc_result": verdict["result"],
            "ywc_score": verdict["score"],
            "ywc_disposable": verdict["disposable"],
            "ywc_validated_at": verdict["metadata"]["timestamp"],
        }},
        timeout=10,
    )

Les propriétés ywc_* sont à créer au préalable dans HubSpot. Pour une base existante de plusieurs milliers de contacts, exportez-la et passez par le traitement par lots plutôt que par une boucle d'appels.