Passer au contenu principal

Comment envoyer un test d'un webhook Klaviyo ?

Vérifiez qu'un webhook Klaviyo déclenche bien votre flow WAX, avec les bonnes variables, avant de le mettre en ligne.

Avant de mettre en ligne un flow WAX déclenché par Klaviyo, envoyez un test depuis le webhook Klaviyo. Vous vérifiez ainsi que l'appel arrive bien dans WAX et que les variables (prénom, lien de panier…) sont correctement remplies. L'exemple de ce guide est un flow d'abandon de checkout.

Avant de commencer : ce qu'il faut savoir

  • Webhook configuré : votre flow WAX utilise Klaviyo comme source de déclenchement, et le webhook Klaviyo contient la Destination URL, le header Authorization et le Bearer Token fournis par WAX. Voir Comment créer un webhook entre WAX et Klaviyo.

  • Flow WAX actif : les variables envoyées par Klaviyo ne peuvent être vérifiées que si le flow est réellement déclenché par Klaviyo et actif dans WAX. Un test manuel lancé depuis WAX seul n'affichera pas les bonnes valeurs.

  • Un profil de test réel : le test s'envoie avec les données d'un profil Klaviyo. Utilisez votre propre profil, avec votre numéro de téléphone.

  • Données de profil et d'événement : dans le JSON body, les variables person.… (sous "attributes") viennent de la fiche du profil. Les variables event.… (ex. {{ event.extra.checkout_url|default:'' }}) viennent de l'événement. Elles ne sont remplies que si votre profil a réellement réalisé cet événement : c'est pourquoi vous commencez par l'action sur votre site.

⚠️ Le flow WAX étant actif, limitez l'envoi à vous-même : ajoutez au flow Klaviyo une condition qui n'envoie le webhook que si le phone_number est le vôtre, ou si l'email se termine par le domaine de votre entreprise.

Étape 1️⃣ : Réalisez l'action de test sur votre site

Déclenchez vous-même l'événement qui démarre le flow Klaviyo, avec le profil qui servira au test.

  • Pour un flow d'abandon de checkout : allez sur votre site, ajoutez un produit au panier, commencez le checkout en renseignant votre email ou votre numéro, puis quittez la page sans commander.

  • Pour un flow déclenché par Added to List (pop-up) : complétez le pop-up avec un profil qui n'est pas encore dans la liste.

Étape 2️⃣ : Patientez le temps de la synchronisation

La donnée entre votre site et Klaviyo peut mettre jusqu'à 15 minutes à se synchroniser. Attendez ce délai avant d'envoyer le test : sinon, l'événement n'est pas encore visible sur le profil, et les variables d'événement arrivent vides.

Étape 3️⃣ : Ouvrez le webhook dans Klaviyo

  1. Ouvrez le flow Klaviyo dans lequel vous avez ajouté le webhook WAX.

  2. Cliquez sur l'action Webhook pour l'ouvrir.

  3. Cliquez sur Preview.

Étape 4️⃣ : Sélectionnez votre profil et envoyez le test

  1. Recherchez le profil avec lequel vous avez réalisé l'action à l'étape 1, puis sélectionnez-le.

  2. Vérifiez dans l'aperçu du JSON body que les variables sont bien remplies : numéro au bon format, prénom, et pour un abandon de checkout, l'URL du panier.

  3. Cliquez sur Send Test.

💡 Une valeur vide dans l'aperçu ("") signifie que la donnée n'existe pas sur ce profil ou cet événement : grâce à |default:'', le webhook part quand même, mais la variable sera vide dans votre message WAX.

Étape 5️⃣ : Vérifiez le message reçu

  • Vous devez recevoir sur votre téléphone le premier message du flow WAX.

  • Vérifiez chaque variable : prénom, lien du bouton (il doit pointer vers checkout_url et non vers un lien fixe), code promo…

  • Si tout est conforme, retirez la condition de test du flow Klaviyo pour l'ouvrir à tous vos contacts.

Pourquoi mon test ne fonctionne-t-il pas ?

  • Aucun message reçu : vérifiez que le flow WAX et le webhook Klaviyo sont bien activés, et que la Destination URL et le token ont été copiés-collés à l'identique, sans espace ajouté.

  • Le webhook échoue : le JSON body contient probablement une erreur de syntaxe (virgule manquante, accolade non fermée, guillemets oubliés). Copiez votre JSON et demandez à une IA (Claude, ChatGPT…) d'en corriger la syntaxe.

  • Une variable est vide : l'événement n'était pas encore synchronisé (attendez 15 minutes et renvoyez le test), ou la variable ne pointe pas vers le bon onglet (Profile ou Event) dans Klaviyo.

Tips & Conseils

  • Testez chaque branche : si votre flow WAX contient des boutons ou des conditions, refaites un test pour chaque parcours.

  • Gardez un profil de test dédié : un profil Klaviyo à votre nom, avec votre numéro, réutilisable pour tous vos tests.

  • Notez l'heure de votre action : vous saurez plus facilement si le délai de synchronisation est écoulé.

Voir aussi

Avez-vous trouvé la réponse à votre question ?