Reazioni: le basi
Come far rispondere il bot a un comando, a un pulsante o a un altro evento. Creare reazioni, stabilirne la priorità e collegarle tra loro.
In questa pagina
Una reazione definisce una regola del bot. Per esempio: «Quando qualcuno scrive /price, invia il listino». Oppure: «Dopo il pagamento, aggiungi l'etichetta “Pagato” e concedi l'accesso».
Nella sezione Reazioni scegli l'evento, le eventuali condizioni e le azioni. Il bot controlla le regole dall'alto verso il basso ed esegue la prima che corrisponde. Metti quindi le regole specifiche sopra la risposta generica a qualsiasi messaggio.
Com'è fatta una reazione
Per inviare il listino bastano il comando /price e un messaggio con i prezzi. Le altre impostazioni servono a limitare la regola a determinate persone o chat. L'editor ha quattro sezioni:
| Sezione | Che cosa definisce | Esempio |
|---|---|---|
| Trigger | Quando partire: testo, comando, contenuto multimediale, pulsante, evento o orario | Una persona scrive /price |
| Nelle chat | Dove funziona: chat privata, richiesta in un gruppo o chat specifiche; tiene conto dello stato dell'utente | Solo in privato |
| Condizioni | Che cosa verificare in più: etichette, parametri, tempo o numero di messaggi | L'utente ha l'etichetta «Pagato» |
| Azioni | Che cosa fare: inviare un messaggio, cambiare etichette, salvare dati o chiamare l'IA | Inviare il listino |
Creare e modificare una reazione
Premi Crea reazione o aprine una esistente. In alto trovi il nome obbligatorio, il numero #N, la descrizione e l'interruttore Attiva. A sinistra scegli Trigger / Nelle chat / Condizioni / Azioni, al centro compili il modulo. A destra vedi l'anteprima Telegram del messaggio, con blocchi, pulsanti e menu. Premi Salva.
Per una reazione salvata, l'editor mostra anche il numero di attivazioni, un grafico e gli eventi recenti.
Cronologia delle modifiche e ripristino
Apri Cronologia delle modifiche in una reazione salvata. Puoi vedere le ultime 20 modifiche con ora, autore, origine e differenze «Prima / Dopo». È possibile ripristinare lo stato precedente a una modifica scelta: esamina prima le differenze, poi conferma.
Il ripristino sostituisce le modifiche non salvate e viene registrato a sua volta nella cronologia. Ripristina le impostazioni, ma non annulla messaggi già inviati o dati già modificati. Se un collega cambia la reazione mentre stai esaminando le differenze, aggiorna il confronto.
Ordine e priorità
Puoi trascinare le reazioni nell'ordine manuale quando non sono attivi ricerca, filtri o una cartella selezionata. L'ordine stabilisce la priorità: alla prima reazione corrispondente il controllo si ferma. Per proseguire e permettere l'esecuzione delle successive, aggiungi l'azione Reazione successiva (goto_next).
Ricerca, filtri e raggruppamento
Sopra l'elenco puoi cercare per nome o numero e usare questi filtri:
- Stato: tutte, solo attive o solo inattive.
- Creata da / fino a: giorni di calendario nel tuo fuso orario, entrambi inclusi.
- Ordine: manuale, più recenti prima o più vecchie prima.
- Raggruppamento: per giorno o mese di creazione. Funziona solo con l'ordine per data. Se lo attivi nell'ordine manuale, l'elenco passa a «Più recenti prima»; un ordine per data già selezionato resta invariato. Tornando all'ordine manuale, il raggruppamento si disattiva.
I filtri si applicano a tutte le reazioni, non solo alla pagina visibile, e si combinano con ricerca e cartelle. Il contatore indica quante reazioni sono state trovate. Le scelte sono conservate nell'URL della pagina: puoi ricaricarla, condividere il link o tornare alla vista con «Indietro». Reimposta filtri azzera ricerca, filtri, ordine e raggruppamento, ma mantiene la cartella scelta.
Queste impostazioni cambiano soltanto l'elenco mostrato: l'ordine con cui il bot prova le reazioni non cambia.
Attivare e disattivare
L'interruttore nell'elenco o Attiva nell'editor abilita o disabilita la reazione senza eliminarla. Il bot ignora quelle disabilitate.
Duplicare ed eliminare
Nella riga della reazione trovi Duplica ed Elimina. La copia è utile se devi creare una regola simile con poche differenze.
Importare ed esportare
Con Esporta nell'editor puoi scaricare una reazione in JSON; con Importa nell'elenco puoi caricarla. In questo modo la sposti tra bot o ne conservi versioni fuori dalla piattaforma.
Inviare una reazione a più persone
Con Invio nella riga della reazione (icona di invio) puoi mandarla a tutti gli iscritti attivi del bot, ad esempio per un annuncio. Puoi restringere il pubblico con le etichette. Leggi Invii massivi.
Catene e dialoghi
Una prima reazione può mostrare un catalogo, un pulsante aprire la scheda prodotto in una seconda reazione e questa chiedere l'indirizzo di consegna. Puoi collegare i passaggi in vari modi:
- Reazione a catena (
chain): avvia un'altra reazione durante l'esecuzione. - Reazione successiva (
goto_next): passa alla prossima reazione corrispondente nell'elenco. - Passi del dialogo: un blocco del messaggio può attendere una risposta, verificandone il formato, e mettere in pausa il flusso. Vedi Messaggi e pulsanti.
- Ramo «altrimenti»: se le condizioni non sono soddisfatte, avvia una reazione alternativa impostata in «Condizioni».
- Scegli il passo successivo (
branch_result): distingue risultati di ricerca vuoti, singoli, multipli o incompleti. - Scegli il passo per valore (
branch_value): ad esempio conferma conupdated, mentre conconflictchiede di rileggere lo stato. - Esito dell'azione: per le azioni che lo supportano, passa a reazioni diverse in caso di successo, conflitto, record mancante o errore. Vedi Rami in base all'esito.
- Chiama blocco (
call_block): passa valori a una logica condivisa e riporta gli output dichiarati nella reazione corrente. Vedi Libreria dei blocchi.
Per lavorare con i dati, puoi creare la catena Cerca nella raccolta → Scegli il passo successivo → pulsanti → Trova record correlati. Per una lista ottenuta da un servizio esterno: Elabora lista → Gruppi e totali. Assegna un nome al risultato di ogni azione e sceglilo nel passo successivo.
Le lezioni pratiche mostrano entrambe le catene con corsi e richieste. Usa il selettore dei dati dei passi precedenti per evitare di scrivere i percorsi a memoria. Prima di salvare, prova la bozza corrente con dati di esempio e confronta rami e messaggi previsti. Dopo il salvataggio, prova anche il percorso reale attraverso il bot e il canale connessi.
Prossimi passi
- Trigger: tutti gli eventi che possono avviare una reazione.
- Condizioni e chat: filtri e ambito.
- Azioni: elenco delle azioni.
- Messaggi e pulsanti: come creare le risposte.