Configurer Klaviyo ou Mailchimp

Wavize synchronise des contacts vers une audience précise

Klaviyo et Mailchimp possèdent des pages de configuration séparées. Chaque intégration demande une clé API, un identifiant de liste/audience, un mode de synchronisation et un statut actif. Lors d’une modification, laisser le champ clé vide conserve le secret déjà enregistré.

Profil seul crée ou met à jour le profil sans prétendre obtenir un consentement marketing. Double opt-in déclenche le processus de confirmation du fournisseur : le contact ne devient abonné qu’après l’action attendue.

Sécurité commune
Créez une clé dédiée Wavize, copiez-la une seule fois dans le formulaire chiffré, ne l’envoyez ni par e-mail ni en capture, et révoquez-la dès qu’elle est exposée.

Configurer Klaviyo avec une clé privée

Wavize utilise les endpoints serveur : la clé publique de six caractères, appelée Site ID, ne convient pas.

1. Créer la clé

   Dans Klaviyo : Settings > API keys > Private API Keys > Create Private API Key. Un rôle Owner, Admin ou Manager est requis. Donnez le nom Wavize et copiez la valeur commençant par pk_ au moment de sa création.

2. Choisir les scopes

   La vérification lit accounts et la liste ; la synchronisation crée/met à jour les profils et, en double opt-in, les abonnements. Accordez au minimum les lectures accounts/lists et écritures profiles/subscriptions correspondant aux endpoints.

3. Trouver l’identifiant de liste

   Ouvrez Audience > Lists & Segments puis la liste cible. Copiez l’ID de la liste depuis ses paramètres ou son URL, pas son nom affiché. Wavize le valide avec /lists/{id}.

Configurer Mailchimp avec clé et Audience ID

La clé Mailchimp Marketing API contient normalement le centre de données après un tiret, par exemple -us21.

1. Créer la clé

   Dans Mailchimp : icône Profil > Profile > Extras > API keys > Create A Key. Nommez-la Wavize, générez puis copiez-la immédiatement : Mailchimp n’affiche ensuite que son nom et ses premiers caractères.

2. Conserver le suffixe datacenter

   Wavize extrait le suffixe après le dernier tiret pour appeler le bon hôte API. Une clé tronquée sans -usXX ne peut pas être routée correctement.

3. Trouver Audience ID

   Dans Audience > All contacts > Settings > Audience name and defaults, copiez Audience ID. Ce n’est ni le nom public, ni un identifiant de campagne.

Choisir profil seul ou double opt-in

Le mode doit correspondre à votre base légale et au texte présenté dans le widget.

• Profil seul

  Klaviyo reçoit un profil ; Mailchimp utilise le statut transactional. Le contact n’est pas présenté comme abonné marketing et peut servir aux usages autorisés non promotionnels.

• Double opt-in

  Klaviyo lance une tâche d’abonnement de profil ; Mailchimp place le membre en pending. L’adresse doit confirmer selon le fournisseur avant d’être active pour le marketing.

• Champs synchronisés

  E-mail valide obligatoire, téléphone E.164 lorsqu’il existe, prénom, nom, organisation, localisation et propriétés Wavize utiles. Les champs Mailchimp FNAME/LNAME doivent exister ou être compatibles dans l’audience.

Vérifier et tester un contact réel de recette

Wavize teste d’abord le compte et l’audience avant d’activer la synchronisation.

1. Vérification Klaviyo

   Le serveur appelle /accounts puis /lists/{id}. Un 403 indique souvent un scope manquant ; un 404, un ID de liste du mauvais compte.

2. Vérification Mailchimp

   Le serveur appelle /ping puis /lists/{id}. Une erreur de datacenter vient souvent du suffixe de clé ; une audience introuvable, d’un ID incorrect.

3. Contact de recette

   Soumettez une adresse appartenant à l’équipe depuis le widget, vérifiez sa création Wavize puis son arrivée chez le fournisseur. En double opt-in, ouvrez et confirmez le message avant de conclure.

Rotation et incident

Une nouvelle clé ne remplace pas automatiquement l’ancienne dans Wavize.

• Créer — Nouvelle clé dédiée avec les mêmes permissions minimales.
• Mettre à jour et tester — Saisir la nouvelle valeur, conserver audience et mode, puis vérifier.
• Révoquer — Supprimer l’ancienne clé chez le fournisseur seulement après le test réussi.