▶ Manual Trigger

Il Manual Trigger avvia un'esecuzione del workflow immediatamente, sia quando un utente clicca il pulsante Esegui Test all'interno dell'editor del workflow, sia quando il workflow viene chiamato programmaticamente tramite l'API di Flusso. È il tipo di trigger più semplice e non richiede configurazione, rendendolo ideale per attività on-demand e test durante lo sviluppo.

Panoramica

Ogni workflow necessita di un trigger — il nodo che decide quando il workflow si avvia. Il Manual Trigger offre il controllo più diretto: il workflow viene eseguito esattamente quando lo decidi tu, senza attendere un evento esterno o un orario programmato.

Quando clicchi Esegui Test nell'editor, Flusso attiva il Manual Trigger ed esegue immediatamente il resto del workflow. Puoi opzionalmente fornire un payload JSON nel pannello di test; quei dati saranno disponibili per gli step successivi come {{ trigger.output.* }}. Questo ti permette di simulare input reali durante lo sviluppo senza necessità di un sistema esterno attivo che invii dati.

In produzione, puoi attivare un Manual Trigger tramite l'API REST di Flusso. Questo è utile per integrare Flusso nelle tue applicazioni: il tuo codice chiama l'API con un payload e Flusso esegue il workflow con quei dati. Esempi comuni includono job batch notturni avviati da un cron job sul tuo server, o operazioni ad-hoc avviate da un pannello di amministrazione interno.

Configurazione

Dati di Output

Il Manual Trigger passa tutti i dati forniti nel payload di esecuzione direttamente nel contesto del workflow. Tutti i campi del payload sono accessibili negli step successivi usando la sintassi variabile indicata di seguito.

Quando esegui un test dall'editor, puoi digitare un oggetto JSON nel pannello del payload di test per pre-compilare questi valori. Quando chiami l'API, fornisci il payload come corpo della richiesta.

Esempio di Utilizzo

Elaborazione documenti on-demand

Supponiamo che tu abbia un workflow che elabora un documento PDF: estrae il testo, lo invia a un agente AI per la sintesi e salva il risultato nella tua knowledge base. Vuoi che un amministratore possa avviarlo su qualsiasi documento in qualsiasi momento.

1. Aggiungi un Manual Trigger come primo nodo. Non è necessaria alcuna configurazione. Il trigger accetterà un payload contenente l'URL del documento.
2. Testa con un payload di esempio nell'editor. Nel pannello di test, inserisci:

   { "document_url": "https://example.com/report.pdf" }

   Clicca Esegui Test per eseguire l'intero workflow con questi dati.
3. Riferisci il payload negli step successivi. Nel nodo HTTP Request che scarica il PDF, imposta il campo URL su {{ trigger.output.document_url }}.
4. Chiama l'API in produzione. Dal tuo pannello di amministrazione, effettua una POST all'endpoint API del workflow con l'URL del documento nel corpo. Flusso esegue il workflow immediatamente.

Suggerimenti e Note

• Il payload è opzionale. Se attivi il trigger senza payload, tutti i riferimenti trigger.output.* negli step successivi restituiranno null. Assicurati che i nodi a valle gestiscano correttamente i valori mancanti (ad esempio, con un controllo Logic Gate).
• Usa per testare qualsiasi workflow. Anche se il tuo workflow utilizzerà un trigger diverso (come Webhook o Schedule), è buona pratica testare prima con il Manual Trigger usando un payload di esempio realistico.
• Autenticazione API richiesta. Quando chiami il workflow tramite API, devi includere un token API Sanctum valido nell'header Authorization: Bearer.
• Il workflow deve essere salvato. Il pulsante Esegui Test esegue l'ultima versione salvata del workflow. Se hai modifiche non salvate, salva prima.

Nodi Correlati

• Webhook Trigger — si attiva quando una richiesta HTTP POST arriva all'URL del workflow.
• Schedule Trigger — si attiva automaticamente secondo una pianificazione cron.
• Event Trigger — si attiva quando un altro workflow emette un evento con nome.