Créer un flux de données dynamique dans WhatsApp

Créez un flux de données dynamique WhatsApp dans ChatMaxima avec des listes dépendantes chaînées alimentées en direct par votre API, comme Catégorie vers Produit ou Médecin vers Date vers Heure.

Vue d'ensemble

Un flux de données dynamique est un flux WhatsApp dont les listes sont alimentées en direct par votre propre API. Chaque étape est une liste, et le choix du client à une étape détermine ce que la prochaine étape affiche. Le flux guide le client à travers une chaîne de sélections dépendantes.

Exemples typiques :

Santé - Médecin, puis Date disponible, puis créneau Horaire disponible.
E-commerce - Catégorie, puis Produit.
Services - Agence, puis Service, puis Membre du personnel.

Contrairement au générateur de formulaires, les options ne sont pas saisies à la main. Lorsque le client passe à l'écran suivant, WhatsApp appelle un point de terminaison sécurisé de ChatMaxima, qui appelle votre API et renvoie la liste suivante. Rien n'est codé en dur, donc le même flux fonctionne pour n'importe quelle chaîne d'étapes que vous définissez.

Comment ça fonctionne

Le client ouvre le flux et voit la liste de la première étape.
Il fait une sélection.
WhatsApp envoie cette sélection au point de terminaison chiffré de ChatMaxima.
ChatMaxima appelle votre API pour l'étape suivante, en transmettant les sélections précédentes.
La liste suivante apparaît. Cela se répète jusqu'à l'écran récapitulatif final.

Prérequis

Avant de commencer, assurez-vous de disposer de :

Un compte WhatsApp connecté - un numéro WhatsApp Cloud API lié à ChatMaxima.
Une API pour chaque étape - un point de terminaison HTTPS qui renvoie une liste JSON d'options.
La clé de chiffrement configurée - une configuration unique par compte WhatsApp, décrite ci-dessous.

Remarque : Les flux de données dynamiques sont pilotés par un point de terminaison, donc WhatsApp exige une clé de chiffrement. Vous devez terminer la configuration du chiffrement avant de pouvoir enregistrer un flux dynamique.

Étape 1 : Démarrez un flux de données dynamique

Allez dans Campagnes puis Flux WhatsApp et cliquez sur Créer un flux.
Saisissez un nom de flux et choisissez une catégorie.
Définissez le type de flux sur Flux de données dynamique.

Le générateur bascule vers la vue Étapes dynamiques.

Étape 2 : Configurez la clé de chiffrement

Un flux de données dynamique appelle un point de terminaison ChatMaxima pour chaque écran, et WhatsApp exige que ce canal soit chiffré.

Dans la carte Chiffrement du point de terminaison, cliquez sur Configurer la clé de chiffrement.
ChatMaxima génère une paire de clés RSA pour le compte et téléverse automatiquement la clé publique vers Meta.

Il s'agit d'une action unique par compte WhatsApp. Chaque flux dynamique sur ce compte réutilise la même clé.

Étape 3 : Ajoutez des étapes

Chaque étape est une liste dépendante. Cliquez sur Ajouter une étape et remplissez l'éditeur d'étape.

Champs de l'étape

Champ	Description
Titre de l'étape	Le titre de l'écran, par exemple `Select a Category`
Clé de l'étape	Un identifiant en minuscules, par exemple `category`, référencé plus tard comme `{category}`
Libellé de la liste	Le libellé affiché au-dessus de la liste
Méthode HTTP	`GET` ou `POST` pour l'appel API
URL de l'API	Le point de terminaison qui renvoie les options de cette étape
Authentification	Aucune, Jeton Bearer, Authentification basique ou En-tête personnalisé

Transmettre les sélections précédentes

Pour qu'une étape ultérieure dépende d'une étape antérieure, placez la clé de l'étape antérieure dans son URL d'API sous forme d'espace réservé. ChatMaxima la remplace par la sélection du client au moment de l'exécution.

https://api.example.com/products?category={category}

Dans cet exemple, l'URL de l'étape product insère la category choisie.

Étape 4 : Mappez la réponse de l'API

La section Mappage de la réponse de l'éditeur d'étape indique à ChatMaxima comment lire le JSON de votre API.

Champ	Description
Chemin de la liste	Chemin vers le tableau dans la réponse, par exemple `data`. Laissez vide si la réponse est déjà un tableau
Champ ID	Le champ utilisé comme valeur de l'option, par exemple `id`
Champ Titre	Le champ affiché comme texte principal de l'option, par exemple `name`
Champ Description	Une ligne secondaire facultative, par exemple `price`

La notation par points est prise en charge pour les champs imbriqués, comme price.amount.

Étape 5 : Enregistrez et publiez

Cliquez sur Enregistrer le flux dynamique. ChatMaxima génère les écrans du flux WhatsApp à partir de vos étapes et les téléverse.
Ouvrez le brouillon enregistré et cliquez sur Publier.

L'écran final est un récapitulatif qui reprend chaque sélection avant que le client ne confirme.

Bonnes pratiques

Utilisez des clés d'étape claires - courtes, en minuscules et significatives, car elles apparaissent dans les URL.
Renvoyez de petites listes - les listes WhatsApp fonctionnent mieux avec un ensemble ciblé d'options.
Ordonnez les étapes du général au spécifique - par exemple Catégorie avant Produit.
Testez chaque API - confirmez que chaque point de terminaison renvoie le JSON attendu avant d'enregistrer.

Dépannage

L'enregistrement échoue en demandant la clé de chiffrement

Ouvrez la carte Chiffrement du point de terminaison.
Cliquez sur Configurer la clé de chiffrement et attendez la confirmation.
Enregistrez à nouveau le flux dynamique.

Une étape affiche une liste vide

Vérifiez que l'URL de l'API est correcte et accessible en HTTPS.
Vérifiez que le chemin de la liste, le champ ID et le champ Titre correspondent au JSON de votre API.
Confirmez que tout {placeholder} dans l'URL correspond à la clé d'une étape antérieure.

Une étape ne parvient pas à atteindre l'API

L'API doit être un point de terminaison HTTPS public. Les adresses internes ou privées sont bloquées pour des raisons de sécurité.
Confirmez que les détails d'authentification sont corrects.