Costruire un flusso di lavoro

Aprire un'automazione occupa tutto lo schermo con il builder: una tela dei nodi a destra, una palette o un inspector a sinistra e una toolbar in alto. Resta aperto sopra la tua area di lavoro; non c'è una pagina o una scheda separata.

In breve

1. Crea o apri un'automazione per entrare nel builder.
2. Trascina un nodo dalla palette sulla tela.
3. Trascina dal connettore di un nodo al nodo successivo per collegarli.
4. Clicca un nodo per aprirne le impostazioni nel pannello di sinistra.
5. Clicca Validate, poi Test per eseguirlo una volta, oppure Activate per andare in produzione.

Riferimento dettagliato

Layout

Area	Cosa contiene
Barra delle icone (all'estrema sinistra)	Tre viste: Flow (la tela), Settings (opzioni per singola automazione), Activity (cronologia delle esecuzioni).
Pannello di sinistra	La palette dei nodi quando non c'è nulla di selezionato, o le impostazioni del nodo selezionato quando ce n'è uno. I due si scambiano di posto sul posto.
Tela	Il grafo vero e proprio: uno sfondo a griglia, pan e zoom, una minimappa e i controlli dello zoom.
Toolbar	Uscita, nome dell'automazione e stato di salvataggio automatico, undo e redo, Validate, una pillola di stato e Test / Activate / Pause.

La palette dei nodi

La palette del pannello di sinistra ha una casella di ricerca e tre schede che rispecchiano il catalogo dei nodi: Triggers, Actions e Rules, ciascuna raggruppata in sottocategorie più piccole (per esempio Design, AI o Notification sotto Actions). Trascina un nodo qualsiasi sulla tela per posizionarlo; vedi Nodi per il catalogo completo.

Collegare i nodi

Trascina dal connettore inferiore di un nodo alla parte superiore del nodo successivo per collegarli. Un trigger non ha ingresso; un nodo di uscita non ha uscita. I nodi di tipo condizione (come If) espongono due connettori, uno per ciascun ramo, così colleghi separatamente un percorso "sì" e un percorso "no".

Configurare un nodo

Clicca un nodo per far passare il pannello di sinistra al suo inspector: un titolo, una breve descrizione e i suoi campi.

Tipo di campo	Reso come
Text	Un input su una sola riga
Textarea	Un input su più righe, per prompt e contenuti più lunghi
Number	Un input numerico, con minimo e massimo dove pertinente
Select	Un menu a discesa; alcuni (come le cartelle) caricano i dati in tempo reale della tua area di lavoro
Boolean	Un interruttore a levetta
Part picker	Un pulsante che apre il selettore di elementi descritto qui sotto

Scegliere un elemento del progetto

Alcuni nodi azione, a cominciare da Pick a part, hanno bisogno di un pezzo specifico di un progetto piuttosto che di un intero design. Il selettore è un overlay a due passaggi sopra il builder: scegli prima un progetto, poi un elemento al suo interno, una pagina, un riquadro o una slide, con un'anteprima in miniatura in tempo reale per ogni progetto. Una volta scelto, un link Open in editor ti porta dritto a quell'elemento preciso.

Gestione degli errori per singolo nodo

L'inspector di ogni nodo ha due schede: Parameters, i campi visti sopra, e Settings, che mostra opzioni solo per i nodi di tipo azione (i trigger e i nodi logici non hanno nulla da configurare qui, dato che non hanno un effetto collaterale da ritentare):

Impostazione	Cosa fa
On error	Continue ingoia il fallimento e prosegue, Stop the run fa fallire l'intera esecuzione, Route to an error output aggiunge un secondo connettore rosso "Hata" in uscita dal nodo così puoi collegare un percorso di fallimento dedicato
Retry (0-5)	Ritenta lo stesso passaggio questo numero di volte prima di ricadere sul comportamento di On error
Wait (ms)	Quanto attendere tra un tentativo di retry e l'altro
Note	Una nota in testo libero sul nodo, per tuo uso personale; non ha alcun effetto sull'esecuzione

Un nodo lasciato sul valore predefinito Continue registra semplicemente un passaggio error e fa avanzare l'esecuzione come se non fosse successo nulla, così un webhook irraggiungibile o un'email respinta non blocca di per sé il resto del grafo.

La vista Settings

La vista Settings della barra delle icone contiene opzioni per l'intera automazione, salvate con la bozza:

Gruppo	Impostazione	Cosa fa
Execution	Concurrency	Free (molte esecuzioni insieme), Single at a time, Skip if busy, o Queue fino a un limite
Execution	Max concurrent	Il limite della coda, mostrato solo in modalità Queue
Execution	Max run duration	Un'esecuzione più vecchia di questi secondi viene fatta fallire automaticamente, anche a metà di un'attesa
Execution	Priority	Le esecuzioni delle automazioni a priorità più alta vengono fatte avanzare per prime quando il motore ha un arretrato
Error	Default on-error behavior	Continue o Stop, usato da qualsiasi nodo che non ha impostato il proprio On error
Error	Error notifications	In-app, email e/o Slack, inviate quando un'esecuzione fallisce
Error	Error automation	Un'altra automazione da avviare (fire-and-forget) ogni volta che questa fallisce
Error	Circuit breaker	Mette automaticamente in pausa l'automazione dopo questo numero di esecuzioni fallite di fila
Scheduling	Quiet hours	Una finestra oraria di inizio/fine (nel fuso orario dell'automazione) durante la quale i trigger vengono rimandati anziché attivati
Scheduling	Debounce	Un intervallo minimo imposto tra un'attivazione e l'altra, in aggiunta a qualsiasi debounce impostato sul nodo trigger stesso
Data & retention	Save execution data	Tutti i log dei passaggi, solo gli errori, o nessuno, un compromesso tra privacy e spazio di archiviazione
Data & retention	Run history retention	Le esecuzioni concluse più vecchie di questi giorni vengono eliminate automaticamente; se il campo è vuoto, si conserva tutto

Nulla di tutto ciò viene controllato da Validate, che verifica solo il grafo in sé; un'impostazione priva di senso (come un limite di coda pari a 0) si comporta semplicemente in modo prudente anziché bloccare Activate.

Controlli della toolbar

Controllo	Cosa fa
Exit	Chiude il builder e torna alla panoramica.
Nome + testo di stato	Mostra il nome dell'automazione e se è salvata, in salvataggio o se il salvataggio è fallito.
Undo / Redo	Torna indietro e avanti tra le tue modifiche al grafo.
Validate	Controlla il grafo ed elenca in linea errori e avvisi, sotto la toolbar.
Status pill	Draft, Active, Paused o Error, a colpo d'occhio.
Test	Salva, poi esegue il grafo una volta immediatamente. Vedi Esecuzione e monitoraggio.
Activate / Pause	Pubblica e va in produzione, oppure smette di ascoltare senza perdere la bozza.

Scorciatoie da tastiera

Scorciatoia	Azione
Delete / Backspace	Elimina il nodo selezionato (e i suoi collegamenti)
Ctrl/Cmd + Z	Undo
Ctrl/Cmd + Shift + Z (oppure Ctrl+Y)	Redo
Ctrl/Cmd + C / V	Copia e incolla il nodo selezionato
Ctrl/Cmd + D	Duplica il nodo selezionato

I nodi trascinati si agganciano a una griglia, e trascinando su una zona vuota della tela si selezionano più nodi con un rettangolo di selezione.

Passo dopo passo

Questi esempi costruiscono automazioni complete e reali da nodi che funzionano davvero oggi (vedi Nodi per sapere quali). Le ancore qui sotto sono collegate da altre pagine.

Guida pratica: un digest AI programmato, via email

1. Trascina un trigger Scheduled sulla tela (scheda Triggers, gruppo Zaman). Apri il suo inspector e imposta la frequenza: scegli Weekly per un giorno fisso, Interval più un valore "Every (minutes)" per una cadenza ravvicinata, oppure Cron con un'espressione cron grezza e un fuso orario per un controllo preciso (vedi Trigger).
2. Trascina un nodo Generate copy da Actions > AI e collega il connettore del trigger a esso. Apri il suo inspector e scrivi un prompt, per esempio "Write 3 short social post ideas for this week, one line each." Questo passaggio usa la chiave del provider AI che hai collegato in Settings > AI; senza, registra un passaggio saltato anziché far fallire l'esecuzione.
3. Trascina un nodo Send email da Actions > Notification e collega Generate copy a esso. Imposta To sul tuo indirizzo, Subject su qualcosa come "This week's post ideas" e Body su {{ context.__aiText }} così porta con sé l'output del passaggio AI.
4. Clicca Validate, correggi ciò che segnala (uno frequente: To o Subject lasciati vuoti), poi clicca Test. Apri la vista Activity e verifica che il passaggio AI abbia prodotto del testo e che il passaggio email mostri ok (o un chiaro motivo di salto se non è ancora configurata alcuna connessione SMTP o chiave AI).
5. Clicca Activate. Ora si esegue da solo secondo la pianificazione che hai configurato; non serve tenere l'app aperta.

Guida pratica: raccolta da webhook con una risposta AI

1. Trascina un trigger Incoming webhook sulla tela. Il suo URL in ingresso è costruito a partire dall'id della stessa automazione (/api/workflow/hook/<automation id>); nel builder non c'è ancora un pulsante per copiare l'URL, quindi trova l'id dalle richieste di rete che la pagina già effettua (per esempio dagli strumenti per sviluppatori del browser mentre il builder è aperto) invece di aspettarti di vederlo stampato sul nodo. Facoltativamente imposta un secret HMAC così vengono accettate solo le richieste che portano una firma valida.
2. Fai puntare a quell'URL uno strumento esterno per moduli, un CRM o un widget di chat come suo target del webhook, con un corpo JSON come { "email": "...", "message": "..." }.
3. Trascina un nodo Set a variable dopo il trigger per normalizzare un campo che riuserai, per esempio la chiave customerEmail, con valore {{ context.email }}.
4. Trascina un nodo Generate copy dopo di esso con un prompt come Write a short, friendly reply to: {{ context.message }}.
5. Trascina un nodo Slack / Discord, incolla l'URL del webhook in ingresso del tuo canale e imposta il messaggio su New submission from {{ context.customerEmail }}: {{ context.__aiText }}.
6. Fai Validate, poi Test con un corpo JSON di esempio (va bene qualsiasi client HTTP, oppure il pulsante "send test event" del tuo strumento, dato che basta un POST all'URL del webhook). Controlla Activity, poi fai Activate.

Guida pratica: ramificare su una condizione dopo un salvataggio

1. Parti da un trigger Design updated; tra i trigger di eventi di design/area di lavoro, questo è quello che l'app attiva automaticamente oggi, ogni volta che un design viene salvato (vedi Trigger).
2. Trascina un Pick a part così i passaggi successivi hanno qualcosa di concreto su cui agire; apri il selettore di elementi e scegli un progetto, poi una pagina, un riquadro o una slide al suo interno.
3. Trascina un nodo Condition (yes/no). Il suo inspector costruisce una regola (un campo, un confronto come uguale a o contiene, e un valore) anziché un'espressione grezza digitata; entrambi i lati della regola possono attingere dal contesto dell'esecuzione.
4. Sul ramo yes, aggiungi una In-app notification che dice al tuo team che l'elemento è pronto per la revisione. Sul ramo no, aggiungi un passaggio Write an audit entry così anche il caso di passaggio senza azione resta registrato.
5. Fai Validate, poi Test; Test si esegue immediatamente a prescindere dal trigger, così puoi provare entrambi i rami senza salvare davvero un design. Verifica che entrambi i percorsi compaiano correttamente in Activity, poi fai Activate.

Risoluzione dei problemi

• La scheda Settings di un nodo appare vuota. Solo i nodi di tipo azione hanno una scheda On error / Retry / Note. I trigger e i nodi logici (Condition, Filter, Delay, Set a variable e simili) non hanno un effetto collaterale da ritentare, quindi la loro scheda Settings non contiene altro che il campo Note.
• Ho impostato "Route to an error output" ma non c'è dove collegare il percorso di fallimento. Un secondo connettore rosso compare sul nodo stesso solo dopo che hai attivato quell'impostazione; guarda di nuovo in fondo al nodo; la nuova maniglia "Hata" si trova accanto all'uscita normale.
• Copia/incolla (Ctrl/Cmd+C/V) sembra non aver fatto nulla. La copia incollata finisce leggermente spostata rispetto all'originale, con un piccolo scarto casuale, non esattamente sopra di esso; guarda appena sotto e a destra del nodo di origine.
• Validate è pulito ma Activate fallisce comunque. Activate riesegue la validazione e pubblica in un unico passaggio; se un campo dipende da dati in tempo reale (come una cartella nel frattempo eliminata), può fallire in quel momento anche se un minuto prima Validate sembrava a posto. Riapri l'inspector del nodo che fallisce e ri-seleziona il valore.
• Un campo obbligatorio mostra un errore che non riesco a trovare. Il messaggio di Validate nomina il nodo e il campo, ma l'inspector mostra solo i campi la cui condizione displayIf è al momento soddisfatta; un campo può essere obbligatorio ma nascosto se un altro campo ne controlla la visibilità (per esempio il corpo del nodo HTTP compare solo dopo aver scelto un metodo che trasporta un corpo).

Suggerimenti

Valida prima di attivare

La validazione intercetta un grafo vuoto, più di un trigger, un campo obbligatorio lasciato vuoto, un collegamento penzolante o un ramo non collegato, prima che tu provi ad andare in produzione.

Le modifiche si salvano da sole

Le modifiche vengono salvate automaticamente un istante dopo che smetti di digitare o di spostare qualcosa; il testo di stato della toolbar lo conferma. Non c'è un pulsante di salvataggio separato.

Eliminare un nodo ne rimuove i collegamenti

Non c'è un passaggio separato per ripulire i collegamenti; eliminare un nodo si porta via tutti i collegamenti che lo toccano.

Correlati

• Nodi
• Trigger
• Esecuzione e monitoraggio
• Tutto è basato sugli elementi