Azioni

Le azioni sono ciò che il bot esegue quando una reazione si attiva. Una reazione può avere più azioni, eseguite nell'ordine dall'alto verso il basso. Si aggiungono con il pulsante Aggiungi azione nella sezione Azioni dell'editor. Le azioni si scambiano dati attraverso il contesto di esecuzione (ctx) e i parametri utente — vedi Sostituzioni e formule.

Messaggi e risposte

  • Invia messaggio — l'azione principale: costruisce la risposta da blocchi (testo, foto, file, ritardo, IA, chiamata di reazione), aggiunge pulsanti inline, menu e passi del dialogo. Dettagli — Messaggi e pulsanti.
  • Salva messaggio — scrive il testo del messaggio in entrata in un parametro utente.
  • Inoltra — inoltra il messaggio in entrata alle chat specificate (con ID topic opzionale).
  • Notifica — invia una notifica alle chat di servizio con i dati dell'utente, della chat e del testo.

Utente: tag e parametri

  • Modifica tag — aggiunge e/o rimuove tag dell'iscritto.
  • Modifica parametri — imposta, elimina o incrementa i valori dei parametri utente.

Moderazione

  • Elimina messaggio ricevuto — elimina il messaggio in entrata (opzionalmente tutti i messaggi dell'utente, con ritardo).
  • Elimina messaggi inviati — elimina i messaggi del bot (di questa reazione o tutti nella chat, con ritardo).
  • Modifica autorizzazioni — silenzia / rimuovi silenzio / banna / rimuovi ban / limita i diritti di un partecipante, per un periodo o definitivamente; per la limitazione si scelgono diritti specifici.
  • Reazione importante (colore) — contrassegna il dialogo con un colore per l'operatore.

Dati e raccolte

  • Crea record — aggiunge una riga a una raccolta; con la «chiave di deduplicazione» funziona come upsert (senza duplicati).
  • Aggiorna record — modifica le righe che corrispondono al filtro.
  • Trova record — legge le righe nel contesto come array (per l'iterazione).
  • Elimina record — elimina le righe in base al filtro.
  • Ciclo su lista — itera su un array da ctx ed esegue le azioni annidate per ogni elemento (ad esempio una trasmissione su una lista).

Maggiori dettagli sulle raccolte — Raccolte e dati.

Richieste esterne

  • Richiesta web — richiesta HTTP (GET/POST/PUT/DELETE) con intestazioni, corpo, codici di successo, timeout e tentativi; la risposta viene salvata in un parametro o ctx tramite JSONPath; può essere eseguita in modo asincrono e avviare reazioni in caso di successo/errore.
  • Carica URL — scarica una pagina e salva il suo testo leggibile in ctx (per l'elaborazione successiva o per l'IA).
  • Richiesta alla sorgente — legge dati da un connettore collegato (REST / OzmaDB) in ctx.
  • Scrittura nella sorgente — scrive dati nel connettore (POST/PUT/DELETE).

Informazioni su sorgenti e chiavi — Sorgenti e chiavi.

IA e calcoli

  • IA — interroga un modello linguistico: prompt, salvataggio della risposta in un parametro/ctx, schema JSON opzionale per l'estrazione di strutture, invio della risposta all'utente. Vedi Risposte IA.
  • Calcolo — calcola tramite formula o tabella decisionale (regole «quando → allora», la prima vera vince) e salva il risultato in ctx/parametro.

Logica e scenari

  • Reazione a catena — avvia un'altra reazione tramite il suo nome.
  • Reazione successiva — passa il controllo alla successiva reazione idonea nell'elenco.
  • Avvia scenario — avvia un wizard passo dopo passo (flow). Vedi Scenari.
  • Richiedi conferma — invia una scheda all'approvatore; i pulsanti «conferma»/«rifiuta» avviano le reazioni configurate.
  • Trasferisci all'operatore — trasferisce il dialogo all'inbox dell'operatore. Vedi Chat e operatori.

Integrazioni

Le azioni GetCourse, Google Sheets e Google Drive si collegano tramite le omonime integrazioni (vedi Integrazioni). Nel costruttore di reazioni queste azioni sono contrassegnate come «presto» — nel frattempo usale tramite la configurazione dell'integrazione, le richieste web o l'IA. L'invio universale a un servizio esterno è disponibile tramite l'integrazione Webhook e l'azione Richiesta web.

Prossimi passi