Pour bien exploiter les webhook sur WAX, vous aurez besoin de notre documentation API disponible ici
Explication en vidéo
Qu’est-ce qu’un Webhook dans WAX ?
Un Webhook est un outil qui relie votre CRM ou base de données à WAX. Il permet :
D’envoyer des données de votre CRM vers WAX pour déclencher des flows WhatsApp (panier abandonné, welcome flow, flow anniversaire)
De transmettre les données collectées dans WhatsApp (comme les clics ou réponses des utilisateurs) vers votre CRM pour l’enrichir avec des informations conversationnelles.
Paramétrer un Webhook entrant (CRM → WAX)
Créez un Webhook dans WAX :
Accédez à l’interface WAX et cliquez sur "Créer un Webhook".
Remplissez les informations demandées, comme le nom du Webhook.
Configurez le JSON Body :
Le JSON Body contient les informations que vous souhaitez transmettre. Par exemple, pour personnaliser un message WhatsApp, envoyez une donnée comme "First Name" depuis votre CRM.
Paramétrer un Webhook sortant (WAX → CRM)
Définissez l’URL de destination :
Renseignez l’URL de votre CRM ou base de données où les données issues de WhatsApp seront envoyées.
Configurez les données à transmettre :
Sélectionnez les variables collectées via WhatsApp, comme les clics sur un bouton ou les réponses utilisateurs. Ces informations seront enrichies dans votre CRM.
Utilisez le Webhook Button (orange) :
Ce bouton permet d’envoyer des données vers votre CRM ou tout autre système compatible.
Si vous utilisez Klaviyo comme CRM, un article dédié est consacré au Webhook avec Klaviyo: disponible ici
Gérer les erreurs de Webhooks
Il peut arriver qu'un Webhook ne fonctionne pas comme prévu (URL incorrecte, service externe indisponible, configuration modifiée de votre côté…)
Pour éviter que votre flow s'arrête net dans ce cas, WAX vous permet de définir un chemin alternatif : c'est ce qu'on appelle le "fallback".
Comment l'activer ?
Lors de la configuration de votre Webhook dans le flow builder, cochez la case "Trigger fallback path on error response".
Une fois cette case cochée, un nouveau bloc apparaît sous votre nœud Webhook. Ce bloc vous permet de construire la suite du flow qui sera déclenchée uniquement si le Webhook rencontre une erreur (par exemple, envoyer un message d'excuse à votre contact, ou orienter vers un autre parcours)
Utiliser les données reçues par Webhook dans votre flow
Si votre Webhook est configuré pour envoyer des variables à WAX (ex. : statut de commande, prénom, score fidélité…), vous pouvez les exploiter directement dans la suite de votre flow.
Comment récupérer ces variables ?
Cliquez sur le bouton "Test webhook" depuis le nœud concerné. WAX va simuler une réception de données et vous afficher les variables envoyées par votre système externe.
Une fois visibles, ces variables deviennent utilisables pour :
Personnaliser vos messages : par exemple, afficher le prénom ou le montant d'une commande
Créer des conditions
