Base de connaissances GetMyBot

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 clientDonnées gardées par le bouton
Manteau, 12 000 ₽ · Acheterproduct_id=101, price=12000
Robe, 8 000 ₽ · Acheterproduct_id=102, price=8000
Baskets, 6 000 ₽ · Acheterproduct_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 :

ChampValeurRésultat
Liste (over)ctx.productsLe 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éfautChaque 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.

  1. Choisissez ctx.products, l’alias item et un bouton par ligne.
  2. Dans le texte du modèle, saisissez {{item.name}} · {{item.price}} ₽.
  3. Choisissez le type Appeler une réaction et la réaction de commande.
  4. Dans Carry, ajoutez product_id avec la valeur {{item.id}}.
  5. 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_seconds ou TTL) : nombre de secondes. 3600 correspond à une heure. 0 choisit 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

BesoinRéglageLire la valeur dans
Transmettre le produit choisi à la réaction suivanteCarry{{ctx.product_id}}
Garder la ville après le choix du clientset_params du bouton{{param.city}}
Enregistrer une valeur dès l’envoiset_params du bloc de message{{param.clé}}

Pour aller plus loin