Make
L'app YesWeCheck pour Make ajoute la vérification d'adresses à vos scénarios : un formulaire, un lead, une ligne de tableur passe par YesWeCheck, et la suite du scénario dépend du verdict. Elle applique les réglages de la clé utilisée (contrôles, SMTP, politique de validation, listes) et débite les mêmes crédits que l'API.
1. Créer une clé Make
Dans l'espace client : Intégrer → Connecteurs → Make, rubrique Créer une clé Make.
| Réglage | Conseil |
|---|---|
| Usage | Un nom par scénario ou par client, par exemple CRM : la clé s'appelle « Make – CRM ». |
| Plafond de crédits par jour | Gardez un plafond : un scénario qui boucle ne videra pas votre solde. |
| Vérification de la boîte (SMTP) | Activée, elle confirme que la boîte existe : 1 crédit par vérification conclusive. |
Copiez la clé tout de suite : elle ne sera plus affichée. Une clé Make est une clé serveur ordinaire, sans le contrôle network (l'adresse IP vue serait celle de Make, pas celle du contact) ni restriction d'origine. Elle apparaît aussi dans Clés API, où vous la révoquez ou la remplacez.
2. Installer l'app dans Make
- Dans l'espace client, page Make, cliquez Ouvrir l'app dans Make, connecté à votre compte Make, et installez l'app YesWeCheck dans votre organisation.
- Dans un scénario, ajoutez un module et cherchez YesWeCheck.
- Au premier module, cliquez Create a connection et collez la clé. Make vérifie la clé et affiche le nom de votre organisation et celui de la clé.
Une clé refusée affiche « [401] Invalid or revoked API key » : vérifiez qu'elle commence par ywc_live_ (ou ywc_test_) et qu'elle n'est pas révoquée.
3. Les modules
| Module | Rôle | Crédits |
|---|---|---|
| Verify an email address | Vérifie une adresse et renvoie le verdict, le score et le détail des contrôles. | Comme l'API : 1 crédit seulement si la clé a le SMTP et que le verdict n'est pas unknown |
| Get credit balance | Solde de l'organisation, nom de la clé, SMTP activé ou non, plafonds et consommation de la clé (renseignée quand la clé a un plafond). | Gratuit |
| Make an API call | Appel libre à l'API, chemin relatif à https://api.yeswecheck.fr (par exemple /v2/me). La clé est déjà ajoutée. | Selon l'endpoint appelé |
Verify an email address
Champ obligatoire : Email address. Champs avancés : Country (pays de référence pour l'analyse du prénom, code ISO comme FR ou GB) et Mailbox check timeout (1 000 à 30 000 ms).
Sorties principales, à relier aux modules suivants :
| Sortie | Contenu |
|---|---|
| Result | valid, risky, invalid ou unknown — voir les verdicts |
| Score (0-100) | Score de délivrabilité |
| Free email provider, Business email, Disposable, Alias | Indicateurs oui/non |
| Policy decision | accepted ou rejected, selon la politique de validation de la clé |
| Checks | Détail de chaque contrôle (syntax, dns, smtp…) : résultat, score, code de motif — voir les contrôles |
| Metadata | Identifiant de requête, date de vérification, crédits utilisés et restants |
La sortie est exactement la réponse de l'API.
4. Exemple de scénario
- Déclencheur : nouvelle réponse de formulaire, nouveau lead ou nouvelle ligne.
- YesWeCheck → Verify an email address, avec l'email du déclencheur.
- Un Router avec un filtre par branche sur Result :
- valid : création du contact dans le CRM ;
- invalid : rien, ou une alerte ;
- risky et unknown : contact créé avec une étiquette « à vérifier ».
- Option : enregistrez Result, Score et Metadata → Checked at sur la fiche du contact.
Pour surveiller le solde, un scénario planifié chaque jour avec Get credit balance et un filtre sur Credits → Balance peut envoyer une alerte.
5. Erreurs
| Message dans Make | Cause | Que faire |
|---|---|---|
[400] email must be an email | Adresse mal formée ou champ vide | Filtrer les valeurs vides avant le module |
[401] Invalid or revoked API key… | Clé révoquée ou erronée | Créer une nouvelle clé et mettre à jour la connexion |
[402] Not enough credits… | Solde de l'organisation insuffisant pour une vérification SMTP | Recharger des crédits — voir Solde insuffisant |
[429] … | Limite d'appels de la clé, ou plafond de crédits de la clé atteint (API_KEY_BUDGET_EXCEEDED) | Make traite l'erreur comme une limite de débit, sans désactiver le scénario. Pour un plafond, attendez sa réinitialisation (00:00 UTC) ou relevez-le. Voir Limites et Plafonds de crédits |
Les autres codes sont décrits dans Erreurs.