Boutons dynamiques et paramètres
Présenter des produits sous forme de boutons, mémoriser un choix et le transmettre à la réaction suivante : Carry, durée de validité et paramètres permanents.
Sur cette page
Le bot présente trois produits, chacun avec un bouton « Acheter ». Une personne choisit la robe. La réaction suivante doit recevoir cette robe précise, même si le bot a montré d’autres produits depuis.
Deux réglages assurent cela : les boutons dynamiques créent des boutons à partir d’une liste, et Carry garde les données propres à chaque bouton. Ils se trouvent dans le bloc de message de l’action Envoyer un message.
| Ce que voit le client | Données gardées par le bouton |
|---|---|
| Manteau, 12 000 ₽ · Acheter | product_id=101, price=12000 |
| Robe, 8 000 ₽ · Acheter | product_id=102, price=8000 |
| Baskets, 6 000 ₽ · Acheter | product_id=103, price=6000 |
Cliquer sur le deuxième bouton transmet product_id=102. Le bot n’a pas à déduire le produit du seul mot « Acheter ».
Boutons dynamiques à partir d’une liste
Plutôt que d’ajouter les produits un par un, obtenez une liste d’une collection ou d’un service externe. Le bloc Boutons dynamiques à partir d’une liste crée un bouton par élément. La liste se trouve dans les données temporaires de la réaction, appelées contexte (ctx) dans les réglages. Configurez quatre champs :
| Champ | Valeur | Résultat |
|---|---|---|
Liste (over) | ctx.products | Le bot lit les produits préparés par Requête vers la source, Requête web ou Calcul |
Alias de l’élément (as) | item, valeur par défaut | {{item.name}} désigne le nom d’un produit |
Boutons par ligne (columns) | 1, valeur par défaut | Chaque produit occupe sa propre ligne |
| Modèle du bouton | {{item.name}} · {{item.price}} ₽ | Le nom et le prix de chaque produit sont insérés dans le texte et les autres champs |
À l’envoi, le bot remplace les valeurs du modèle pour chaque produit. Une liste de trois produits produit trois boutons. La même méthode convient à des cours disponibles, des commandes ou des choix de menu.
Exemple
ctx.products contient des produits avec id, name et price.
- Choisissez
ctx.products, l’aliasitemet un bouton par ligne. - Dans le texte du modèle, saisissez
{{item.name}} · {{item.price}} ₽. - Choisissez le type Appeler une réaction et la réaction de commande.
- Dans Carry, ajoutez
product_idavec la valeur{{item.id}}. - Dans la réaction de commande, lisez
{{ctx.product_id}}pour identifier le produit choisi.
Cliquez sur le deuxième bouton, puis sur le premier : chaque appel doit recevoir l’ID correspondant au bouton cliqué.
Données transmises au clic : Carry
Carry désigne les données que le bouton transmet lors du clic. Imaginez une étiquette attachée à chaque produit : même si tous les boutons disent « Acheter » et lancent la même réaction, chacun porte sa propre étiquette.
Dans l’éditeur, le réglage s’appelle Données au clic. Les valeurs sont mémorisées à l’envoi du message. Au clic, le bot les lit et les place dans ctx, les données temporaires de la nouvelle exécution.
- Clé : nom de la valeur mémorisée. Avec
product_id, lisez{{ctx.product_id}}. - Valeur : nombre ou substitution, comme
{{item.id}},{{param.order_id}}ou{{ctx.x}}. La substitution est évaluée à l’envoi. - Usage unique (
single_use) : les données sont effacées après le premier clic. - Durée de conservation (
ttl_secondsou TTL) : nombre de secondes.3600correspond à une heure.0choisit la durée par défaut, actuellement 30 jours ; ce n’est pas illimité.
Après expiration, les anciennes données ne sont plus disponibles : donnez au client un moyen de rouvrir le catalogue. Chaque bouton envoyé a son propre jeu de valeurs, même s’il a le même texte et la même réaction cible. Les descriptions techniques appellent cela per-invocation.
Enregistrer des paramètres au clic : set_params
Parfois, le choix doit rester disponible après la fin de la réaction. Si le client choisit une ville de livraison, le bot peut en avoir besoin pour sa prochaine commande. Le champ Paramètres (set_params) du bouton enregistre la ville dans la fiche d’abonné au clic. Elle devient accessible par {{param.city}}.
Carry transmet des valeurs temporaires à l’exécution en cours ({{ctx.clé}}). set_params garde les valeurs entre exécutions ({{param.clé}}). Le bloc de message possède aussi set_params, mais il enregistre à l’envoi du message, même si personne ne clique.
Un bouton peut également ajouter ou retirer des étiquettes au clic, avec les mêmes champs que le bloc de message.
Choisir entre ces trois mécanismes
| Besoin | Réglage | Lire la valeur dans |
|---|---|---|
| Transmettre le produit choisi à la réaction suivante | Carry | {{ctx.product_id}} |
| Garder la ville après le choix du client | set_params du bouton | {{param.city}} |
| Enregistrer une valeur dès l’envoi | set_params du bloc de message | {{param.clé}} |
Pour aller plus loin
- Messages et boutons : blocs, types de boutons et action au clic.
- Substitutions et formules :
{{item.*}},{{ctx.*}}et{{param.*}}. - Liens entre réactions : destinations et graphe des transitions.
- Collections et données : sources des listes.