Connecter Mailchimp

Le connecteur Mailchimp vérifie l'adresse email des contacts de vos audiences et écrit le résultat sur chaque contact, dans des champs de fusion ou en tags. Le principe commun à tous les connecteurs est décrit dans Connecteurs : principe.

1. Créer une clé API Mailchimp

1. Dans Mailchimp, cliquez sur l'icône de votre profil, puis Profil.
2. Ouvrez Extras → Clés API (accès direct : admin.mailchimp.com/account/api).
3. Cliquez sur Créer une clé, nommez-la « YesWeCheck » et copiez-la : Mailchimp ne la réaffiche plus.

La clé se termine par le code de votre serveur Mailchimp (par exemple -us21) : copiez-la entière. Elle agit avec les droits de l'utilisateur qui l'a créée ; créez-la de préférence depuis un utilisateur Administrateur ou Propriétaire du compte.

2. Connecter

Dans l'espace client : Intégrer → Connecteurs → Mailchimp, collez la clé, puis Tester et connecter. Le nom de votre compte Mailchimp s'affiche quand la clé est acceptée. Une clé refusée n'est pas enregistrée.

3. Nettoyer une audience

Choisissez une audience, ou un segment ou un tag d'une audience, puis Lancer le nettoyage. Trois étapes :

1. YesWeCheck lit les contacts dans Mailchimp.
2. 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 Mailchimp.
3. À la fin, les résultats sont écrits dans Mailchimp. Une notification vous en donne le bilan.

Les contacts nettoyés par Mailchimp (rebonds définitifs) et les contacts désinscrits sont ignorés, et non facturés, tant que l'option Ignorer les contacts déjà nettoyés ou désinscrits est active (par défaut). Les contacts archivés ne sont pas lus.

Une même adresse présente dans deux audiences correspond à deux contacts dans Mailchimp : chaque audience se nettoie séparément.

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 Mailchimp

Champs de fusion (par défaut)

À la première écriture dans une audience, YesWeCheck y crée quatre champs de fusion s'ils n'existent pas. Ils sont masqués de vos formulaires d'inscription.

Champ (balise)	Type Mailchimp	Contenu
YWC – Statut (YWC_STATUS)	Liste déroulante	Valide, Risqué, Invalide ou Inconnu
YWC – Score (YWC_SCORE)	Nombre	0 à 100
YWC – Motif (YWC_REASON)	Liste déroulante	Motif (voir la liste des motifs), vide si rien à signaler
YWC – Dernière vérification (YWC_DATE)	Date	Jour de la vérification

Pour écarter les adresses à risque, créez dans Mailchimp un segment sur YWC – Statut (par exemple « est Invalide ») et excluez-le de vos campagnes. Les balises s'utilisent aussi dans vos emails (*|YWC_STATUS|*).

Une audience compte un nombre limité de champs de fusion. Si elle n'a plus de place, YesWeCheck vous le signale : supprimez un champ inutilisé, ou passez en tags seulement.

Adresses postales incomplètes

Comportement propre à Mailchimp

Quand l'adresse postale d'un contact est à moitié remplie (il manque la rue, la ville ou le code postal), Mailchimp en décale les morceaux à la mise à jour suivante de la fiche, quel que soit l'outil qui la modifie : la ville passe dans « État », « USA » apparaît dans le code postal…

Pour que vos adresses ne bougent pas, YesWeCheck relit l'adresse de chaque contact juste avant d'écrire ses champs. Si elle est à moitié remplie, il la renvoie telle qu'elle s'affiche dans Mailchimp, en mettant un tiret - dans les cases vides (rue, ville, état ou code postal). Le tiret arrête le décalage. Vous pouvez compléter l'adresse plus tard : une adresse complète n'est plus jamais modifiée.

Les contacts sans adresse postale, et ceux dont l'adresse est complète, ne sont pas concernés : YesWeCheck n'envoie alors aucune adresse.

Si vous préférez que YesWeCheck ne modifie aucun champ de vos fiches, activez Écrire les résultats en tags seulement.

Tags seulement

Avec l'option Écrire les résultats en tags seulement, aucun champ n'est créé ni modifié, et l'adresse postale n'est jamais renvoyée. Chaque contact reçoit un tag selon son verdict :

Tag	Verdict
YWC : Valide	valid
YWC : Risqué	risky
YWC : Invalide	invalid
YWC : Inconnu	unknown

Quand le verdict change, l'ancien tag est retiré. Le score, le motif et la date ne sont pas écrits dans ce mode. Changer de mode fait réécrire tous les contacts au nettoyage suivant.

Options pour les adresses invalides

Toutes sont désactivées par défaut.

Option	Effet dans Mailchimp
Regrouper les adresses invalides	Ajoute le tag YWC – invalide aux contacts invalid, sans retirer leurs autres tags (sans objet en mode tags : YWC : Invalide joue ce rôle)
Désinscrire les adresses invalides	Passe les contacts invalid au statut Désinscrit. Ils restent dans l'audience, et dans votre décompte de contacts Mailchimp ; seul le contact lui-même peut se réinscrire
Archiver les adresses invalides	Archive les contacts invalid : ils sortent de l'audience et ne sont plus comptés dans votre forfait Mailchimp à partir de la période de facturation suivante (Mailchimp facture le pic de contacts de la période). Leur historique est conservé ; vous pouvez les restaurer depuis Mailchimp

L'archivage passe en dernier : un contact archivé reçoit d'abord ses champs ou son tag.

Vérifier un contact

Sur la page du connecteur, Vérifier un contact : saisissez une adresse. YesWeCheck la cherche dans toutes vos audiences, la vérifie une fois, SMTP compris, et écrit le résultat sur chaque contact qui la porte (un par audience) : un seul crédit. Les options ci-dessus s'appliquent comme pour un nettoyage. Une adresse absente de Mailchimp n'est pas vérifiée et ne coûte aucun crédit.

Vérifier automatiquement les nouveaux inscrits

Activez Vérifier automatiquement les nouveaux contacts, choisissez les audiences à surveiller et un plafond journalier.

YesWeCheck consulte Mailchimp toutes les 5 minutes : chaque contact inscrit depuis l'activation dans une audience surveillée (formulaire, import, ajout manuel ou autre intégration) est vérifié, SMTP compris, et son résultat écrit. Un contact en double opt-in est vérifié dès qu'il confirme son inscription. Les contacts déjà présents au moment de l'activation ne sont pas concernés : nettoyez l'audience pour eux. Le plafond journalier borne la consommation de crédits ; au-delà, les nouveaux inscrits du jour ne sont pas vérifiés.

Rien n'est installé dans Mailchimp pour cette option : la désactiver, ou déconnecter Mailchimp, l'arrête aussitôt. Les segments ne peuvent pas être surveillés, seulement les audiences.

Déconnecter

Déconnecter efface la clé chez YesWeCheck et arrête la vérification automatique. Les champs YWC et les tags déjà écrits restent sur vos contacts ; supprimez-les dans Mailchimp si vous n'en voulez plus.

Pour couper l'accès immédiatement, côté Mailchimp, désactivez ou supprimez la clé API dans Profil → Extras → Clés API.

Dépannage

Message	Cause	Que faire
« Clé refusée par l'outil »	Clé incomplète (le suffixe -us… manque), désactivée ou supprimée dans Mailchimp	Copiez la clé entière, ou créez-en une nouvelle, et reconnectez
« Cette audience Mailchimp a atteint sa limite de champs de fusion »	Plus de place pour les quatre champs YWC	Supprimez un champ inutilisé, ou activez Écrire les résultats en tags seulement
« Un traitement par lot est déjà en cours »	Un autre lot tourne dans l'organisation	Attendez sa fin
« Aucun contact Mailchimp ne porte cette adresse »	Vérification d'un contact : adresse absente de vos audiences, ou archivée	Vérifiez l'orthographe ; aucun crédit n'est débité
Connexion À reconnecter	Mailchimp refuse la clé enregistrée	Saisissez une clé valide sur la page du connecteur