Passer au contenu principal

Configurer un déclencheur via un outil externe

Lancer une automatisation WAX depuis un événement externe ou un outil tiers, par webhook.

Le déclencheur (trigger) détermine le moment où un contact entre dans un flux WhatsApp ou RCS/SMS. Il est toujours lié à un événement provenant de votre CRM ou de votre outil marketing. La façon de le configurer varie selon l'outil choisi : ce guide couvre les trois cas possibles.

Étape 1 : Identifier votre cas parmi les trois façons de déclencher un flow

Shopify, Prestashop et Yotpo disposent d'événements natifs prêts à l'emploi dans WAX :

  • les événements sont déjà définis (commande, statut, action de fidélité…) ;

  • aucune configuration technique avancée n'est requise ;

  • les données sont automatiquement reconnues par WAX.

Attentive, Splio, Brevo, Batch, Adobe Campaign, Salesforce et Skeepers peuvent déclencher des appels API vers WAX : la configuration passe par un webhook dédié à l'outil connecté, plutôt que par un événement natif.
​

Le guide à suivre dépend de l'outil :

Ces guides dédiés couvrent les spécificités propres à chaque outil (où activer le webhook, quels champs mapper, etc.), mais le fonctionnement de l'API reste le même quel que soit l'outil : URL de destination, header d'authentification et format JSON, comme décrit à l'Étape 2.

Klaviyo : suivez le guide dédié Comment créer un webhook entre WAX et Klaviyo

Si votre outil n'apparaît dans aucune des deux listes ci-dessus, sélectionnez Webhook WAX → Incoming Webhook. Cette option générique permet de :

  • connecter n'importe quel outil externe ;

  • déclencher un flux depuis votre système ;

  • envoyer les données nécessaires au scénario.

💬 Si vous passez par un middleware type Zapier ou Make pour faire le pont entre votre outil et WAX, contactez-nous via le chat en bas à droite : on vous accompagne dans la configuration.

Exemples d'événements courants

Voici des exemples d'événements qui peuvent servir de déclencheur, quel que soit votre secteur d'activité, du moment que l'événement est remonté à WAX selon l'une des méthodes ci-dessus :

  • Opt-in / consentement : ajout à une liste d'opt-in WhatsApp, RCS ou SMS.

  • E-commerce : abandon de panier, abandon de paiement (checkout non finalisé), abandon de navigation (visite sans ajout au panier), retour en stock d'un produit.

  • Fidélité : palier atteint dans un programme de fidélité (points, statut VIP…).

  • Autres secteurs : candidature acceptée, rendez-vous confirmé, formulaire complété, et plus largement tout événement métier propre à votre activité.

Étape 2 : Utiliser les données du trigger dans votre flow

Une fois le trigger configuré, les données transmises par l'outil peuvent être exploitées pour personnaliser vos messages WhatsApp ou RCS/SMS via les attributs contact.

👀 Le format JSON ci-dessous ne concerne que les triggers configurés par webhook (l'option générique Webhook WAX, ou un webhook dédié à un outil). Pour un trigger natif (Shopify, Prestashop, Yotpo Loyalty), les données sont déjà reconnues automatiquement par WAX : vous n'avez rien à structurer vous-même, sauf si vous ciblez un événement particulier que WAX ne remonte pas nativement, dans ce cas, vous pouvez passez par un webhook "Incoming Webhook".

Exemple : utiliser une date d'anniversaire remontée par webhook

  • Créez l'attribut dans WAX. L'attribut birthday_date doit exister préalablement dans WAX.

  • Vérifiez que votre outil transmet bien la donnée. Assurez-vous qu'il envoie birthday_date dans le trigger (via webhook ou événement).

  • Utilisez l'attribut dans vos messages. Une fois reçu par WAX, il est disponible comme variable dans le contenu de vos messages.

  • Respectez le format attendu. Pour que WAX reconnaisse et stocke l'attribut, le trigger doit envoyer un JSON body structuré ainsi (remplacez les valeurs "à remplir" par les vôtres, le reste, comme {{ person.phone_number|default:'' }}, est la syntaxe telle quelle) :

{
"phone_number": "{{ person.phone_number|default:'' }}",
"attributes": {
"email": "à remplir",
"first_name": "à remplir",
"birthday_date": "à remplir"
}
}

🔐 URL de destination et authentification : pour un trigger Webhook -> ouvrez le bloc Trigger (Start Node) de votre flow dans WAX : le panneau de configuration à droite affiche l'URL de destination, le header Authorization et le Bearer Token, générés automatiquement pour ce flow. Copiez-les (icône presse-papier) et reportez-les dans votre outil ou votre système :

POST <URL de destination copiée dans WAX>
Authorization: Bearer <Bearer Token copié dans WAX>

Chaque flow a sa propre URL et son propre token : ne réutilisez pas ceux d'un autre flow. Pour un appel direct à l'API WAX (hors Incoming Webhook), le bearer token se trouve sur le panneau de configuration et également dans Réglages > Organisation > Intégrations > API Requests.

👉 Pour le détail technique complet (types de champs, authentification, endpoints), consultez la documentation technique WAX.

Tant que l'attribut est créé dans WAX et correctement transmis par l'outil source, il est automatiquement disponible dans vos flux : pour la personnalisation des messages, pour construire des conditions, et pour créer des segments basés sur les données de vos contacts.

4. Utiliser les variables sur WAX et activer le flow

⚠️ Important : pour que les variables apparaissent dans le sélecteur de variables de WAX, le flow doit être activé, et vous devez avoir déjà déclenché un premier appel réel (via l'API ou le webhook) qui nous a transmis ces données. Tant qu'aucun appel n'a été reçu, WAX n'a aucun moyen de savoir quelles variables proposer.

Une fois ce premier appel reçu, la liste des variables disponibles apparaît dans le bloc Webhook : cliquez dessus pour la consulter.

Vous pourrez ensuite les utiliser directement dans votre flow, comme ceci :

Avant de mettre un flux en production :

  • Activez le flow, puis déclenchez un premier appel réel (via l'API ou le webhook configuré) pour que WAX reçoive les données et rende les variables disponibles.

  • Mettez à jour les liens et variables sur WAX. Sur votre message WAX, remplacez les liens et champs statiques par les bonnes variables issues du webhook. Par exemple, dans un flow de relance de panier ou de paiement abandonné : le bouton ou lien de relance doit pointer vers la variable checkout_url (et non un lien fixe), et le prénom affiché dans le message doit utiliser la variable first_name. Vérifiez chaque message du flow pour vous assurer qu'aucune variable n'a été oubliée.

  • Testez le déclenchement avec un événement réel.

  • Vérifiez que le contact entre bien dans le flux, avec les bonnes données.

Articles connexes

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