Pulsanti dinamici e parametri
Mostra i prodotti con pulsanti, conserva la scelta e passala alla reazione successiva. Esempi di Carry, scadenza e parametri permanenti.
In questa pagina
Il bot mostra tre prodotti, ciascuno con il pulsante «Acquista». La persona sceglie un vestito. La reazione successiva deve ricevere proprio quel vestito, anche se nel frattempo il bot ha mostrato altri prodotti.
Servono due impostazioni: i pulsanti dinamici creano pulsanti da un elenco di prodotti, mentre Carry conserva il prodotto associato a ciascun pulsante. Entrambe si trovano nel blocco messaggio dell'azione «Invia messaggio».
| Cosa vede il cliente | Dati conservati dal pulsante |
|---|---|
| Cappotto, 12.000 ₽ · Acquista | product_id=101, price=12000 |
| Vestito, 8.000 ₽ · Acquista | product_id=102, price=8000 |
| Scarpe da ginnastica, 6.000 ₽ · Acquista | product_id=103, price=6000 |
Premendo il secondo pulsante, lo scenario riceve product_id=102. Il bot non deve indovinare il prodotto dalla scritta «Acquista».
Pulsanti dinamici da lista
Invece di aggiungere i prodotti uno per volta, ottieni un elenco da una raccolta o da un servizio esterno. Il blocco «Pulsanti dinamici da lista» crea un pulsante per elemento. L'elenco si trova nei dati temporanei della reazione, chiamati contesto (ctx). Configura quattro campi:
| Campo | Valore di esempio | Risultato |
|---|---|---|
Lista (over) | ctx.products | Il bot usa i prodotti nei dati temporanei, preparati prima da «Richiesta alla sorgente», «Richiesta web» o «Calcolo» |
Alias dell'elemento (as) | item, valore predefinito | {{item.name}} indica il nome di un prodotto dell'elenco |
Pulsanti per riga (columns) | 1, valore predefinito | Ogni prodotto appare su una riga distinta |
| Modello del pulsante | {{item.name}} · {{item.price}} ₽ | Il bot inserisce nome e prezzo nel testo e negli altri campi di ogni pulsante |
All'invio il bot sostituisce i dati di ciascun prodotto nel modello. Da tre prodotti nascono tre pulsanti. Puoi fare lo stesso con corsi disponibili, ordini o voci di menu.
Esempio
In ctx.products c'è un elenco di prodotti con i campi id, name e price.
- Indica
ctx.productscome lista,itemcome alias e un pulsante per riga. - Nel testo del modello scrivi
{{item.name}} · {{item.price}} ₽. - Scegli il tipo di pulsante «Chiama reazione» e la reazione che completa l'ordine.
- In Carry, aggiungi la chiave
product_idcon valore{{item.id}}. - Nella reazione dell'ordine, leggi
{{ctx.product_id}}per conoscere il prodotto scelto.
Premi prima il secondo pulsante, poi il primo. Ogni volta la reazione deve ricevere l'ID del prodotto premuto.
Parametri nel tap (Carry)
Carry sono i dati che il pulsante passa quando viene premuto. Pensa all'etichetta di un prodotto: ogni pulsante ha la propria, anche se tutti dicono «Acquista» e avviano la stessa reazione.
Nell'editor l'impostazione si chiama «Dati alla pressione». I valori vengono fissati all'invio del messaggio. Alla pressione, il bot li legge e li mette in ctx, cioè nei dati temporanei della nuova esecuzione della reazione.
- Chiave: nome del valore salvato. Per
product_id, leggi{{ctx.product_id}}. - Valore: numero o sostituzione da conservare, per esempio
{{item.id}},{{param.order_id}},{{ctx.x}}. La sostituzione viene calcolata all'invio. - Monouso (
single_use): dopo la prima pressione i dati vengono eliminati e non possono essere riutilizzati. - Durata dei dati del pulsante (
ttl_seconds, TTL): tempo di conservazione in secondi.3600significa un'ora.0sceglie la durata predefinita, attualmente 30 giorni; non significa durata illimitata.
Alla scadenza i dati precedenti non sono più disponibili: consenti alla persona di riaprire il catalogo. Ogni pulsante inviato conserva i propri valori, anche se testo e reazione di destinazione sono uguali. Nella documentazione tecnica questa proprietà si chiama per-invocation.
Impostazione di parametri tramite pulsante (set_params)
A volte serve ricordare la scelta anche dopo la fine della reazione: per esempio, la città di consegna scelta oggi va usata nel prossimo ordine. Il pulsante ha un campo «Parametri» (set_params) che salva il valore nella scheda dell'iscritto alla pressione. La città sarà poi disponibile come {{param.city}}.
Carry passa valori temporanei all'esecuzione corrente ({{ctx.chiave}}), mentre set_params li conserva tra esecuzioni ({{param.chiave}}). Il blocco messaggio ha anch'esso set_params, ma in quel caso scrive il valore all'invio, anche se la persona non preme nulla.
Un pulsante alla pressione può anche aggiungere e rimuovere etichette — con gli stessi campi del blocco messaggio.
Differenza tra i tre meccanismi
| Esigenza | Impostazione | Dove leggere il risultato |
|---|---|---|
| Passare il prodotto scelto alla reazione successiva | Carry | {{ctx.product_id}} |
| Ricordare la città dopo la scelta | set_params sul pulsante | {{param.city}} |
| Salvare subito un valore quando il messaggio viene inviato | set_params sul blocco | {{param.chiave}} |
Passo successivo
- Messaggi e pulsanti — blocchi del messaggio, tipi di pulsanti e comportamento alla pressione.
- Sostituzioni e formule — variabili
{{item.*}},{{ctx.*}},{{param.*}}nei template. - Link delle reazioni — dove portano i pulsanti e come vedere il grafo delle transizioni.
- Raccolte e dati — dove prendere le liste per i pulsanti dinamici.