Connectez votre compte Klaviyo à Goodweek pour gérer les profils, listes, segments, campagnes, flux et événements directement depuis votre espace de travail IA.
ℹ️ Note sur la gouvernance
Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur au sein de Klaviyo, garantissant l'alignement avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations spécifiques et l'accès authentifié de chaque utilisateur.
📋 Prérequis
Avant qu'un utilisateur puisse voir et connecter l'intégration Klaviyo, l'administrateur de votre organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.
Configuration administrateur
L'intégration Klaviyo utilise une clé API. Aucun flux OAuth ni approbation au niveau administrateur n'est requis au sein de Klaviyo. L'utilisateur qui se connecte doit générer une clé API privée depuis son compte Klaviyo.
⚠️ Seuls les utilisateurs disposant d'un accès aux clés API peuvent se connecter
Dans Klaviyo, seuls les utilisateurs ayant le rôle Propriétaire, Administrateur ou Gestionnaire peuvent créer des clés API privées. Les utilisateurs standards (Analyste, Lecteur ou rôles personnalisés sans accès API) ne peuvent pas générer de clé et ne pourront pas se connecter.
Si un utilisateur standard doit se connecter, demandez à un propriétaire ou administrateur de votre compte Klaviyo de générer une clé API privée en son nom et de la partager de manière sécurisée.
Générer une clé API privée Klaviyo
Avant de vous connecter dans Goodweek, vous devez générer une clé API privée depuis votre compte Klaviyo :
Connectez-vous à Klaviyo.
Allez dans Paramètres → Compte → Clés API.
Faites défiler jusqu'à Clés API privées et cliquez sur Créer une clé API privée.
Donnez à la clé un nom descriptif (par exemple, Goodweek).
Sélectionnez Clé personnalisée et accordez au minimum un Accès complet aux périmètres pertinents pour votre cas d'usage (Profils, Listes, Segments, Campagnes, Événements, Flux).
Cliquez sur Créer et copiez la clé immédiatement — Klaviyo ne l'affiche qu'une seule fois.
Connexion de l'utilisateur
Dans Goodweek, allez dans Intégrations.
Trouvez Klaviyo et cliquez sur Connecter.
Collez votre clé API privée Klaviyo dans le champ prévu à cet effet.
Cliquez sur Connecter pour finaliser la configuration.
Remarques importantes
Chaque utilisateur doit se connecter avec sa propre clé API.
La clé API hérite des autorisations de l'utilisateur qui l'a créée.
Si la clé API est révoquée ou supprimée dans Klaviyo, l'intégration cessera de fonctionner. Générez une nouvelle clé et reconnectez-vous.
Vous pouvez révoquer l'accès de Goodweek à tout moment en supprimant la clé API depuis Klaviyo → Paramètres → Compte → Clés API → Clés API privées.
Outils disponibles
Outil | Description | Type |
Obtenir les profils | Récupère une liste paginée des profils du compte Klaviyo. | Lecture |
Obtenir un profil | Récupère un profil Klaviyo spécifique via son ID. | Lecture |
Créer un profil | Crée un nouveau profil dans le compte Klaviyo. | Écriture |
Mettre à jour un profil | Met à jour les attributs d'un profil Klaviyo existant. | Écriture |
Obtenir les listes | Récupère toutes les listes du compte Klaviyo. | Lecture |
Obtenir une liste | Récupère les détails d'une liste Klaviyo spécifique. | Lecture |
Créer une liste | Crée une nouvelle liste dans le compte Klaviyo. | Écriture |
Ajouter des profils à une liste | Ajoute des profils à une liste Klaviyo via des IDs de profil ou des adresses e-mail. | Écriture |
Obtenir les profils d'une liste | Récupère tous les profils membres d'une liste Klaviyo spécifique. | Lecture |
Obtenir les segments | Récupère tous les segments du compte Klaviyo. | Lecture |
Obtenir un segment | Récupère les détails d'un segment Klaviyo spécifique. | Lecture |
Obtenir les profils d'un segment | Récupère les profils appartenant à un segment Klaviyo spécifique. | Lecture |
Obtenir les campagnes | Récupère une liste des campagnes du compte Klaviyo. | Lecture |
Obtenir une campagne | Récupère les détails d'une campagne Klaviyo spécifique. | Lecture |
Créer une campagne | Crée une nouvelle campagne dans Klaviyo pour l'e-mail ou le SMS. | Écriture |
Attribuer un modèle de message de campagne | Crée une version non réutilisable d'un modèle et l'attribue à un message de campagne. | Écriture |
Obtenir les flux | Récupère tous les flux configurés dans le compte Klaviyo. | Lecture |
Obtenir un flux | Récupère les détails d'un flux Klaviyo spécifique. | Lecture |
Obtenir les actions d'un flux | Récupère les actions au sein d'un flux Klaviyo spécifique. | Lecture |
Obtenir les métriques | Récupère toutes les métriques disponibles dans le compte Klaviyo. | Lecture |
Obtenir une métrique | Récupère les détails d'une métrique Klaviyo spécifique. | Lecture |
Créer des événements clients en masse | Suit l'activité des profils en créant plusieurs événements. | Écriture |
Obtenir les modèles | Récupère tous les modèles d'e-mail du compte Klaviyo. | Lecture |
Obtenir un modèle | Récupère un modèle d'e-mail spécifique. | Lecture |
Créer un modèle | Crée un nouveau modèle d'e-mail dans le compte Klaviyo. | Écriture |
Supprimer une liste | Supprime définitivement une liste Klaviyo. | ⚠️ Destructif |
Supprimer une campagne | Supprime définitivement une campagne Klaviyo. | ⚠️ Destructif |
Supprimer un modèle | Supprime définitivement un modèle d'e-mail Klaviyo. | ⚠️ Destructif |
Cas d'usage
Consulter et mettre à jour des profils à la demande. Récupérez des profils spécifiques par e-mail ou ID, vérifiez leurs attributs et appartenances à des listes, et mettez à jour leurs informations depuis Goodweek.
Vérifier l'appartenance à des listes et segments. Récupérez les profils d'une liste ou d'un segment spécifique depuis Goodweek pour vérifier la composition de l'audience avant de lancer une campagne.
Consulter le statut des campagnes et flux. Obtenez les détails d'une campagne ou vérifiez quels flux sont actifs dans votre compte depuis une conversation Goodweek.
Suivre les événements et surveiller les métriques. Accédez aux métriques Klaviyo pour vérifier quels événements sont suivis et utilisez ces données pour orienter vos décisions de segmentation ou de campagne.
Dépannage
Je ne peux pas générer de clé API dans Klaviyo
Seuls les utilisateurs Klaviyo ayant le rôle Propriétaire, Administrateur ou Gestionnaire peuvent créer des clés API privées. Si vous n'avez pas l'un de ces rôles, demandez à un propriétaire ou administrateur de générer une clé en votre nom.
L'intégration cesse de fonctionner après la connexion
La clé API a peut-être été supprimée ou révoquée dans Klaviyo. Allez dans Klaviyo → Paramètres → Compte → Clés API et vérifiez que la clé est toujours active. Si ce n'est pas le cas, générez-en une nouvelle et reconnectez-vous dans Goodweek.
Intégration non visible dans Goodweek
Assurez-vous que l'administrateur de votre organisation a activé l'intégration Klaviyo depuis le Panneau d'administration Goodweek, dans l'onglet Intégrations.