Connecter Mailjet
Le connecteur Mailjet vérifie vos contacts, ou une de vos listes, et écrit le résultat sur chaque contact, dans quatre propriétés de contact. Le principe commun à tous les connecteurs est décrit dans Connecteurs : principe.
1. Copier votre clé API et votre clé secrète
- Dans Mailjet, ouvrez le menu du compte, puis Paramètres du compte.
- Section Paramètres REST API, ouvrez Gestion des clés API (accès direct : app.mailjet.com/account/apikeys).
- Copiez la clé API et la clé secrète du compte dont vous voulez vérifier les contacts.
Dans Mailjet, chaque sous-compte a ses propres clés et ses propres contacts : utilisez la clé du sous-compte à nettoyer. La clé du compte principal ne voit que les contacts du compte principal.
Si vous régénérez la clé secrète dans Mailjet, YesWeCheck ne peut plus se connecter : reconnectez Mailjet avec la nouvelle.
2. Connecter
Dans l'espace client : Intégrer → Connecteurs → Mailjet, collez la clé API et la clé secrète, puis Tester et connecter. Le nom de votre compte Mailjet (et du sous-compte, le cas échéant) s'affiche quand les clés sont acceptées. Des clés refusées ne sont pas enregistrées.
3. Nettoyer vos contacts
Choisissez Tous les contacts ou une de vos listes, puis Lancer le nettoyage. Trois étapes :
- YesWeCheck lit les contacts dans Mailjet.
- Les adresses sont vérifiées comme un traitement par lots : vous suivez la progression dans Traitement par lot, où le lot porte le badge Mailjet.
- À la fin, les résultats sont écrits dans Mailjet. Une notification vous en donne le bilan.
Les contacts exclus des campagnes, ceux qui vous ont signalé comme spam et, pour une liste, ceux qui s'en sont désinscrits sont ignorés, et non facturés, tant que l'option Ignorer les contacts exclus des campagnes ou désinscrits est active (par défaut).
Les résultats sont écrits contact par contact : Mailjet n'a pas d'écriture groupée qui laisse de côté les contacts supprimés entre-temps. Comptez environ 25 000 contacts mis à jour par heure, après la vérification. Un nettoyage interrompu reprend seul là où il s'est arrêté, et les nettoyages suivants ne réécrivent que les contacts dont le verdict a changé.
Un seul traitement par lots peut tourner à la fois dans une organisation : un nettoyage attend la fin d'un lot en cours.
Ce qui est écrit dans Mailjet
Au premier nettoyage, YesWeCheck crée quatre propriétés de contact si elles n'existent pas :
| Propriété | Type Mailjet | Contenu |
|---|---|---|
ywc_status | Texte | valid, risky, invalid ou unknown |
ywc_score | Nombre décimal | 0 à 100 |
ywc_reason | Texte | Motif (voir la liste des motifs), vide si rien à signaler |
ywc_last_check | Date | Date et heure de la vérification |
Une propriété supprimée dans Mailjet est recréée au nettoyage suivant.
Pour écarter les adresses à risque, créez dans Mailjet un segment sur la propriété ywc_status (par exemple « est égal à invalid ») et excluez-le de vos campagnes.
Options pour les adresses invalides
Toutes sont désactivées par défaut.
| Option | Effet dans Mailjet |
|---|---|
| Regrouper les adresses invalides | Ajoute les contacts invalid à la liste YWC – invalides, en désinscrits de cette liste : une campagne envoyée par erreur à cette liste ne part vers personne. Leurs autres listes ne changent pas |
| Désinscrire les adresses invalides de la liste | Désinscrit les contacts invalid de la liste nettoyée, ou de la liste surveillée où ils sont arrivés. Pour un nettoyage de Tous les contacts et pour Vérifier un contact, ils sont désinscrits de toutes leurs listes. Ils restent dans vos contacts |
| Exclure les adresses invalides des campagnes | Coche Exclu des campagnes sur les contacts invalid : plus aucune campagne ne leur est envoyée, quelle que soit la liste. Les emails transactionnels (API d'envoi) partent toujours. Réversible à tout moment depuis la fiche du contact |
Vérifier un contact
Sur la page du connecteur, Vérifier un contact : saisissez l'adresse d'un contact Mailjet. Elle est vérifiée, SMTP compris, le verdict s'affiche et les propriétés sont écrites sur le contact. Les options ci-dessus s'appliquent comme pour un nettoyage. Une adresse absente de Mailjet n'est pas vérifiée et ne coûte aucun crédit.
Vérifier automatiquement les nouveaux contacts
Activez Vérifier automatiquement les nouveaux contacts, choisissez les sources à surveiller (Tous les nouveaux contacts, ou une ou plusieurs listes) et un plafond journalier.
YesWeCheck consulte Mailjet toutes les 5 minutes :
- avec Tous les nouveaux contacts, chaque contact créé depuis l'activation (formulaire d'inscription, import, API, autre intégration) est vérifié ;
- avec une liste, chaque contact ajouté à la liste depuis l'activation est vérifié, y compris un contact qui existait déjà dans votre compte.
La vérification inclut le SMTP, et les propriétés sont remplies dans la foulée. Un contact arrivé par plusieurs sources surveillées n'est vérifié, et facturé, qu'une fois. Les contacts déjà présents au moment de l'activation ne sont pas concernés : nettoyez la liste pour eux. Le plafond journalier borne la consommation de crédits ; au-delà, les nouveaux contacts du jour ne sont pas vérifiés.
Rien n'est installé dans Mailjet pour cette option : la désactiver, ou déconnecter Mailjet, l'arrête aussitôt.
Déconnecter
Déconnecter efface les clés chez YesWeCheck et arrête la vérification automatique. Les propriétés ywc_* et la liste YWC – invalides restent dans votre compte ; supprimez-les dans Mailjet si vous n'en voulez plus.
Pour couper l'accès immédiatement, côté Mailjet, régénérez la clé secrète dans Gestion des clés API.
Dépannage
| Message | Cause | Que faire |
|---|---|---|
| « Clé refusée par l'outil » | Clé API ou clé secrète incomplète, ou clé secrète régénérée depuis | Copiez les deux clés en cours dans Mailjet et reconnectez |
| « Votre compte Mailjet a déjà une propriété de contact ywc_… d'un autre type » | Une propriété du même nom existe avec un autre type (nombre entier au lieu de décimal, par exemple) | Supprimez-la dans Mailjet, elle sera recréée au nettoyage suivant |
| « L'outil limite temporairement les appels » | Quota d'appels Mailjet atteint, souvent par une autre intégration sur la même clé | Le traitement reprend seul ; sinon réessayez plus tard |
| « Un traitement par lot est déjà en cours » | Un autre lot tourne dans l'organisation | Attendez sa fin |
| « Aucun contact Mailjet ne porte cette adresse » | Vérification d'un contact : adresse absente du compte (ou d'un autre sous-compte) | Vérifiez l'orthographe et le sous-compte connecté ; aucun crédit n'est débité |
| Connexion À reconnecter | Mailjet refuse les clés enregistrées | Saisissez des clés valides sur la page du connecteur |