Connecter Klaviyo

À quoi sert cette connexion ?

Klaviyo permet à ELChat de retrouver les listes et profils, consulter les campagnes email et leurs performances, puis inscrire un contact avec confirmation utilisateur.

Ce dont vous avez besoin

ELChat demande une clé API privée Klaviyo au format pk_.... N’utilisez pas la clé publique ou Site ID.

Créer la clé et ses scopes

1. Connectez-vous à Klaviyo.
2. Ouvrez Settings > API keys > Private API Keys.
3. Cliquez sur Create Private API Key.
4. Nommez-la ELChat.
5. Accordez les scopes nécessaires aux appels implémentés :
   • lists:read ;
   • profiles:read et profiles:write ;
   • subscriptions:write ;
   • campaigns:read.
6. Créez la clé et copiez-la immédiatement.

Klaviyo n’affiche la clé complète qu’une fois et ne permet pas toujours de modifier ensuite ses scopes. Voir la documentation officielle d’authentification Klaviyo.

Connecter et vérifier

1. Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
2. Cliquez sur Connecter sur la carte Klaviyo.
3. Collez la clé privée pk_... et validez.
4. Demandez à ELChat de lister les listes, puis recherchez un profil test connu.

Capacités disponibles

Capacité réelle	Type
Lister les listes accessibles	Lecture
Rechercher un profil par email et lire son consentement	Lecture
Inscrire un profil à une liste, après confirmation	Écriture
Lister les campagnes email, 10 par défaut et 50 maximum	Lecture
Consulter les performances d’une campagne	Lecture

ELChat ne crée pas et n’envoie pas de campagne. Le comportement simple ou double opt-in dépend de la configuration de la liste Klaviyo.

Limitation de configuration actuelle

Le moteur prévoit une liste par défaut, mais le formulaire actuel ne permet pas de la renseigner. Listez d’abord les listes et utilisez l’ID choisi lors de l’inscription.

Reconnecter, déconnecter et dépanner

Créez une nouvelle clé avec les mêmes scopes, reconnectez et testez avant de révoquer l’ancienne.

• 403 / scope manquant : recréez une clé avec le scope requis.
• Profil introuvable : vérifiez l’adresse et le compte Klaviyo connecté.
• Liste requise : choisissez un ID retourné par la liste des listes.
• Inscription non visible immédiatement : l’opération Klaviyo est traitée comme une tâche en masse et le double opt-in peut attendre la confirmation du contact.

Sécurité et conformité

La clé privée doit rester secrète. Accordez uniquement les scopes ci-dessus et ne lancez une inscription qu’après consentement explicite du destinataire.