🇮🇹 IT

✅ Approval

Mette in pausa il workflow e attende che un utente approvi o rifiuti l'azione prima di continuare. Una notifica in-app e (opzionalmente) un'email vengono inviate all'approvatore assegnato. Se approvato, il workflow prosegue allo step successivo. Se rifiutato, il workflow si interrompe con uno stato che riflette il rifiuto.

Categoria: Interazione Umana / Utente · Identificatore tipo: approval

Panoramica

Il nodo Approval introduce un punto di decisione umana in un workflow altrimenti automatizzato. Quando l'esecuzione raggiunge questo nodo, il workflow entra nello stato In attesa e una scheda attività appare nella pagina Attività per l'approvatore assegnato. L'approvatore legge il titolo e la descrizione, poi clicca Approva per permettere al workflow di continuare o Rifiuta per interromperlo.

Questo è essenziale per workflow che comportano conseguenze nel mondo reale — invio di email in massa, transazioni finanziarie, pubblicazione di contenuti o attivazione di azioni irreversibili — dove è richiesta l'approvazione umana prima di procedere.

Le esecuzioni rifiutate terminano immediatamente. Se hai bisogno di eseguire un'azione in caso di rifiuto (ad esempio, notificare il team dei contenuti), aggiungi un nodo In-App Notification o Email Notification prima del nodo Approval, oppure costruisci un workflow separato per la gestione degli errori.

Configurazione

Campo	Stato	Descrizione
Assignee	Obbligatorio	Indirizzo email o ID utente della persona che deve approvare. Supporta riferimenti `{{ variable }}`.
Title	Obbligatorio	Breve descrizione mostrata all'approvatore, ad esempio `Approva fattura #{{ trigger.output.invoice_id }}`.
Description	Opzionale	Spiegazione più dettagliata per aiutare l'approvatore nella sua decisione. Supporta riferimenti `{{ variable }}`.
Timeout	Opzionale	Tempo massimo di attesa per una risposta, in minuti. Se il timeout scade senza una decisione, il workflow fallisce. Lascia vuoto per attendere indefinitamente.
Send Email	Opzionale	Interruttore. Quando attivo, invia un'email all'assegnatario oltre alla notifica in-app. Richiede SMTP configurato nelle Impostazioni.

Dati di Output

Questi campi sono disponibili per gli step successivi se il workflow è stato approvato. Un workflow rifiutato termina senza produrre output.

Campo	Tipo	Descrizione
`approved`	boolean	True se l'approvatore ha cliccato Approva, false se ha cliccato Rifiuta.
`decision`	string	`approved` o `rejected`.
`decided_by`	string	Email o ID utente della persona che ha preso la decisione.
`decided_at`	string	Timestamp ISO 8601 della decisione.
`notes`	string	Commento opzionale inserito dall'approvatore al momento della decisione.

Esempio di Utilizzo

Un nodo Agent redige un'email di marketing e la memorizza nel suo output.
Un nodo Approval è configurato con l'email del responsabile marketing come Assignee. Il Title riporta Rivedi e approva la bozza della campagna, e la Description include {{ agent.output.text }} così il responsabile può vedere l'intera bozza inline.
Se il responsabile clicca Approva, il workflow prosegue a un nodo Email Notification che invia la campagna alla mailing list.
Se il responsabile clicca Rifiuta, il workflow si interrompe. Un nodo In-App Notification precedente (posizionato prima del nodo Approval) ha già allertato il team dei contenuti di rimanere in attesa di feedback.

Suggerimenti & Note

Usa riferimenti {{ variable }} nel Title e nella Description per mostrare dati rilevanti dagli step precedenti, così l'approvatore ha il contesto completo senza dover cercare altrove.
Il workflow rimane nello stato In attesa indefinitamente finché l'approvatore non agisce, a meno che non sia impostato un Timeout.
Imposta un Timeout per decisioni urgenti come approvazioni di fatture o finestre di pubblicazione, così l'esecuzione non resta sospesa per sempre se l'approvatore non è disponibile.
Usa il campo Assignee con una variabile per instradare le approvazioni dinamicamente — ad esempio, assegnare a un team lead in base al dipartimento nel payload del trigger.
Nodi Approval multipli possono apparire in un singolo workflow per processi di firma a più stadi.

Nodi Correlati

Manual Input — mette in pausa e raccoglie dati tramite form da un utente anziché una semplice decisione approva/rifiuta.
In-App Notification — avvisa il revisore che la sua approvazione è richiesta.
Email Notification — invia una notifica email in aggiunta o in alternativa all'interruttore Send Email integrato.