Connecter Klaviyo
Le connecteur Klaviyo vérifie vos profils, une de vos listes ou un de vos segments, et écrit le résultat sur chaque profil, dans quatre propriétés personnalisées. Le principe commun à tous les connecteurs est décrit dans Connecteurs : principe.
1. Créer une clé API privée
Il faut être propriétaire, administrateur ou gestionnaire du compte Klaviyo.
- Dans Klaviyo, cliquez sur le nom de votre compte en bas à gauche, puis Paramètres → Clés API (accès direct : klaviyo.com/settings/account/api-keys).
- Créer une clé API privée, nommez-la par exemple
YesWeCheck. - Choisissez un accès personnalisé et donnez ces droits :
| Droit | Niveau | Sert à |
|---|---|---|
| Accounts | Lecture | Afficher le nom de votre compte |
| Lists | Accès complet | Lister vos listes, créer et remplir la liste YWC – invalides, retirer un profil d'une liste |
| Profiles | Accès complet | Lire les profils et y écrire le résultat |
| Segments | Lecture | Lister vos segments et leurs profils |
| Subscriptions | Accès complet | Option Supprimer les adresses invalides dans Klaviyo |
- Copiez la clé (elle commence par
pk_). Klaviyo ne la réaffiche plus ensuite.
La liste des droits est aussi affichée, copiable d'un clic, dans le formulaire de connexion de l'espace client. Une clé en accès complet fonctionne aussi. Les droits d'une clé Klaviyo ne se modifient pas : s'il en manque un, créez une nouvelle clé et reconnectez Klaviyo.
2. Connecter
Dans l'espace client : Intégrer → Connecteurs → Klaviyo, collez la clé, puis Tester et connecter. Le nom de votre compte Klaviyo s'affiche quand la clé est acceptée. Une clé refusée, ou à laquelle il manque un droit, n'est pas enregistrée ; le message indique les droits à donner.
3. Nettoyer vos profils
Choisissez Tous les profils, une de vos listes ou un de vos segments, puis Lancer le nettoyage. Trois étapes :
- YesWeCheck lit les profils dans Klaviyo.
- 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 Klaviyo.
- À la fin, les résultats sont écrits dans Klaviyo. Une notification vous en donne le bilan.
Les profils supprimés (au sens Klaviyo : rebond, plainte, suppression manuelle) et désinscrits des emails marketing sont ignorés, et non facturés, tant que l'option Ignorer les profils supprimés ou désinscrits est active (par défaut). Les profils sans adresse email (SMS seulement) sont ignorés.
Les résultats sont écrits par imports groupés, profil par profil identifié : un profil effacé dans Klaviyo entre la lecture et l'écriture n'est jamais recréé. Un nettoyage interrompu reprend seul, et les nettoyages suivants ne réécrivent que les profils 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 Klaviyo
Quatre propriétés personnalisées, ajoutées au profil à la première écriture (rien à créer à l'avance) :
| Propriété | Contenu |
|---|---|
ywc_status | valid, risky, invalid ou unknown |
ywc_score | 0 à 100 |
ywc_reason | Motif (voir la liste des motifs), vide si rien à signaler |
ywc_last_check | Date et heure de la vérification (ISO 8601, UTC) |
Pour écarter les adresses à risque, créez dans Klaviyo un segment sur la propriété ywc_status (par exemple « est égal à invalid ») et excluez-le de vos campagnes, ou utilisez la propriété comme condition d'un flux.
Options pour les adresses invalides
Toutes sont désactivées par défaut.
| Option | Effet dans Klaviyo |
|---|---|
| Regrouper les adresses invalides | Ajoute les profils invalid à la liste YWC – invalides. Leurs autres listes et leur consentement ne changent pas : c'est un repère pour vos segments, pas un blocage. Ne ciblez pas cette liste dans une campagne |
| Retirer les adresses invalides de la liste | Retire les profils invalid de la liste nettoyée, ou de la liste surveillée où ils sont arrivés. Pour un nettoyage de Tous les profils et pour Vérifier un contact, ils sont retirés de toutes leurs listes, sauf YWC – invalides. Sans effet sur un segment, qui se recalcule seul. Le profil et son consentement ne changent pas |
| Supprimer les adresses invalides dans Klaviyo | Passe les profils invalid en supprimé (suppressed) : plus aucun email marketing ne leur part, quelle que soit la liste, et Klaviyo ne les compte plus dans les profils actifs de votre forfait. Le profil reste, avec son historique ; la suppression s'annule depuis Klaviyo |
Vérifier un contact
Sur la page du connecteur, Vérifier un contact : saisissez l'adresse d'un profil Klaviyo. Elle est vérifiée, SMTP compris, le verdict s'affiche et les propriétés sont écrites sur le profil. Les options ci-dessus s'appliquent comme pour un nettoyage. Une adresse absente de Klaviyo n'est pas vérifiée et ne coûte aucun crédit.
Vérifier automatiquement les nouveaux profils
Activez Vérifier automatiquement les nouveaux contacts, choisissez les sources à surveiller (Tous les nouveaux profils, une ou plusieurs listes, un ou plusieurs segments) et un plafond journalier.
YesWeCheck consulte Klaviyo toutes les 5 minutes :
- avec Tous les nouveaux profils, chaque profil créé depuis l'activation (formulaire d'inscription, import, API, autre intégration) est vérifié ;
- avec une liste ou un segment, chaque profil entré depuis l'activation est vérifié, y compris un profil 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 profil arrivé par plusieurs sources surveillées n'est vérifié, et facturé, qu'une fois. Les profils déjà présents au moment de l'activation ne sont pas concernés : nettoyez la source pour eux. Le plafond journalier borne la consommation de crédits ; au-delà, les nouveaux profils du jour ne sont pas vérifiés.
Un segment dont les profils entrent et sortent souvent (engagement récent, par exemple) déclenche une vérification à chaque entrée : préférez une liste ou Tous les nouveaux profils si vous voulez vérifier chaque adresse une seule fois.
Rien n'est installé dans Klaviyo pour cette option : la désactiver, ou déconnecter Klaviyo, l'arrête aussitôt.
Déconnecter
Déconnecter efface la clé 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 Klaviyo si vous n'en voulez plus.
Pour couper l'accès immédiatement, côté Klaviyo, supprimez la clé dans Paramètres → Clés API.
Dépannage
| Message | Cause | Que faire |
|---|---|---|
| « Clé refusée par l'outil » | Clé incomplète, ou supprimée dans Klaviyo | Créez une clé privée et reconnectez |
| « La clé est valide mais n'a pas tous les droits nécessaires » | Un droit du tableau ci-dessus manque | Créez une nouvelle clé avec ces droits (Klaviyo ne permet pas d'en ajouter à une clé existante) |
| « L'outil limite temporairement les appels » | Quota d'appels Klaviyo atteint, souvent partagé avec vos autres intégrations | 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 Klaviyo ne porte cette adresse » | Vérification d'un contact : adresse absente du compte | Vérifiez l'orthographe ; aucun crédit n'est débité |
| Connexion À reconnecter | Klaviyo refuse la clé enregistrée | Saisissez une clé valide sur la page du connecteur |