Reazioni: basi
Una reazione è il blocco fondamentale del bot: una regola che descrive quando attivarsi, in quali condizioni e cosa fare. Il bot è un elenco ordinato di reazioni; per ogni evento in entrata la piattaforma scorre l'elenco dall'alto verso il basso e applica la prima reazione idonea. La sezione si trova nel menu a sinistra: Reazioni.
Struttura di una reazione
Una reazione è composta da quattro parti (schede dell'editor):
- Trigger — l'evento a cui la reazione risponde: testo, comando, media, pressione di un pulsante, evento di sistema, pianificazione ecc. Vedi Trigger.
- Nelle chat — dove la reazione è attiva: chat privata, gruppi quando si menziona il bot, chat specifiche; più filtri sullo stato dell'utente.
- Condizioni — filtri aggiuntivi (tag, parametri, ora, numero di messaggi ecc.). Vedi Condizioni e chat.
- Azioni — cosa fa il bot quando si attiva: invia un messaggio, aggiunge tag, scrive in una raccolta, chiama un'IA ecc. Vedi Azioni.
Creazione e modifica
Clicca su Crea reazione (oppure apri una reazione esistente). Nell'intestazione dell'editor: nome (obbligatorio), numero #N, descrizione e interruttore Attiva. A sinistra — la navigazione tra le sezioni Trigger / Nelle chat / Condizioni / Azioni, al centro — il modulo, a destra — l'anteprima Telegram, che mostra come apparirà il messaggio con i blocchi, la tastiera e il menu. Salva con il pulsante Salva.
Per una reazione già salvata, l'editor mostra un pannello statistiche: numero di attivazioni, grafico e ultimi eventi.
Ordine e priorità
Le reazioni nell'elenco possono essere trascinate — l'ordine determina la priorità. Per ogni evento si attiva la prima reazione idonea, dopodiché la scansione si ferma. Per continuare la scansione e permettere l'attivazione delle reazioni successive idonee, aggiungi l'azione Reazione successiva (goto_next).
Attivazione e disattivazione
L'interruttore nella riga dell'elenco (o Attiva nell'editor) attiva e disattiva la reazione senza eliminarla. Le reazioni disattivate vengono saltate durante la scansione.
Duplicazione ed eliminazione
Nella riga dell'elenco sono presenti i pulsanti Duplica (crea una copia) ed Elimina. La duplicazione è utile quando si vuole creare una reazione simile con piccole differenze.
Importazione ed esportazione
Una reazione può essere esportata in JSON (pulsante Esporta nell'editor) e reimportata (Importa nell'elenco). Questo consente di trasferire una reazione tra bot e di conservare versioni al di fuori della piattaforma.
Trasmissione della reazione
Il pulsante Trasmissione nella riga della reazione (icona «invia») invia questa reazione a tutti gli iscritti attivi del bot — utile per annunci e notifiche. Il pubblico può essere ristretto per tag. Maggiori dettagli — Trasmissioni.
Catene e dialoghi
Da più reazioni si costruiscono scenari:
- Reazione a catena (
chain) — un'azione che avvia un'altra reazione durante l'esecuzione. - Reazione successiva (
goto_next) — passa il controllo alla successiva reazione idonea nell'elenco. - Passi del dialogo — un blocco messaggio può attendere la risposta dell'utente (con verifica del formato), mettendo lo scenario in pausa. Vedi Messaggi e pulsanti.
- Ramo «altrimenti» — se le condizioni della reazione non sono soddisfatte, è possibile avviare un'altra reazione (campo nella sezione «Condizioni»).
Prossimi passi
- Trigger — tutti i tipi di attivazione.
- Condizioni e chat — filtri e area di azione.
- Azioni — elenco completo delle azioni.
- Messaggi e pulsanti — costruttore di risposte.