Knowledge base GetMyBot

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:

SezioneChe cosa definisceEsempio
TriggerQuando partire: testo, comando, contenuto multimediale, pulsante, evento o orarioUna persona scrive /price
Nelle chatDove funziona: chat privata, richiesta in un gruppo o chat specifiche; tiene conto dello stato dell'utenteSolo in privato
CondizioniChe cosa verificare in più: etichette, parametri, tempo o numero di messaggiL'utente ha l'etichetta «Pagato»
AzioniChe cosa fare: inviare un messaggio, cambiare etichette, salvare dati o chiamare l'IAInviare 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.

Guida con esercizio.

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 con updated, mentre con conflict chiede 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