Aller au contenu principal

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églageConseil
UsageUn nom par scénario ou par client, par exemple CRM : la clé s'appelle « Make – CRM ».
Plafond de crédits par jourGardez 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​

  1. Dans l'espace client, page Make, cliquez Ouvrir l'app dans Make, connecté à votre compte Make, et installez l'app YesWeCheck dans votre organisation.
  2. Dans un scénario, ajoutez un module et cherchez YesWeCheck.
  3. 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​

ModuleRôleCrédits
Verify an email addressVé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 balanceSolde 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 callAppel 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 :

SortieContenu
Resultvalid, risky, invalid ou unknown — voir les verdicts
Score (0-100)Score de délivrabilité
Free email provider, Business email, Disposable, AliasIndicateurs oui/non
Policy decisionaccepted ou rejected, selon la politique de validation de la clé
ChecksDétail de chaque contrôle (syntax, dns, smtp…) : résultat, score, code de motif — voir les contrôles
MetadataIdentifiant 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​

  1. Déclencheur : nouvelle réponse de formulaire, nouveau lead ou nouvelle ligne.
  2. YesWeCheck → Verify an email address, avec l'email du déclencheur.
  3. 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 ».
  4. 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 MakeCauseQue faire
[400] email must be an emailAdresse mal formée ou champ videFiltrer les valeurs vides avant le module
[401] Invalid or revoked API key…Clé révoquée ou erronéeCréer une nouvelle clé et mettre à jour la connexion
[402] Not enough credits…Solde de l'organisation insuffisant pour une vérification SMTPRecharger 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.