Trigger

Ogni grafo inizia con esattamente un nodo trigger. Un trigger non esegue di per sé alcuna logica, decide soltanto quando il resto del grafo riceve una nuova esecuzione.

Panoramica rapida

1. Trascina un solo nodo trigger sulla tela; è il primo nodo e non ha connettore di ingresso.
2. Configuralo, se richiede dei campi (la cadenza di una pianificazione, una cartella da monitorare).
3. Attiva l'automazione così inizia ad ascoltare quel trigger.
4. Oppure salta tutto questo e premi Test in qualsiasi momento per eseguire il grafo una volta a prescindere dal trigger.

Riferimento dettagliato

Manual

Manual start non ha campi. È ciò che usa il pulsante Test del builder: pubblica il draft corrente, poi mette subito in coda un'esecuzione.

Scheduled

Scheduled scatta con una cadenza che imposti tu.

Campo	Opzioni
Frequency	Interval, Daily, Weekly o Cron
Every (minutes)	Usato solo in modalità Interval
Cron expression	Usata solo in modalità Cron; una standard espressione a 5 campi (minuto ora giorno-del-mese mese giorno-della-settimana), per esempio 0 9 * * 1-5 per i giorni feriali alle 09:00
Timezone	Usato solo in modalità Cron; un nome IANA come Europe/Istanbul. Se lasciato vuoto, l'espressione viene confrontata con l'orologio del server stesso

Un'automazione pianificata attiva viene controllata su un ciclo ricorrente in background; non devi tenere l'app aperta. Le modalità Interval, Daily e Weekly scattano rispetto all'ultimo momento di attivazione dell'automazione stessa. La modalità Cron mantiene un puntatore "prossima scadenza" e recupera un minuto mancato (un deploy, un riavvio, un tick lento) scattando una volta appena se ne accorge, invece di perdere silenziosamente quell'occorrenza; non scatta mai due volte per la stessa finestra mancata.

Incoming webhook

Incoming webhook assegna a ogni automazione un URL in ingresso univoco, /api/workflow/hook/<automation id>, che avvia un'esecuzione quando viene chiamato con una richiesta GET o POST. Scatta solo mentre lo stato dell'automazione è Active.

Al momento il builder non mostra né copia questo URL per te; l'inspector del nodo ha soltanto il campo HMAC secret. Per usarlo, tu (o uno sviluppatore del tuo team) hai bisogno dell'id dell'automazione, che puoi leggere dalle richieste di rete che l'app già effettua mentre il builder è aperto, e combinarlo tu stesso con il percorso fisso /api/workflow/hook/.

Eventi di design e area di lavoro

Questi scattano quando succede qualcosa altrove nell'app. Oggi, Design updated è collegato per scattare automaticamente ogni volta che un design viene salvato. Gli altri sono configurabili fin da ora; man mano che quelle superfici vengono sviluppate, altre azioni dell'app vengono collegate a essi.

Nodo	Scatta quando
Design created	Viene creato un nuovo design
Design updated	Un design viene salvato
Design shared	Un design viene condiviso o pubblicato
Design downloaded	Un design viene scaricato
Part tagged	Viene aggiunto un tag a un elemento (con filtro facoltativo su un singolo tag)
Brand applied	Un kit del brand viene applicato a un design
Asset uploaded	Un file viene aggiunto alla libreria multimediale
AI generation done	Una generazione AI termina
New work in folder	Un progetto viene aggiunto a una cartella scelta da te

Il ponte degli eventi

Qualsiasi tipo di trigger può anche essere avviato tramite una chiamata API generica e autenticata, con ambito la tua area di lavoro: un triggerType e un payload facoltativo. È così che il hook di aggiornamento del design descritto sopra scatta dietro le quinte, ed è disponibile perché le tue integrazioni lo chiamino allo stesso modo.

Più automazioni, un solo tipo di trigger

Più di un'automazione attiva può usare lo stesso tipo di trigger. Il salvataggio di un design, per esempio, può avviare in una volta ogni automazione Design updated attiva della tua area di lavoro, ciascuna eseguita in modo indipendente con la propria cronologia.

Come si usa

Guida pratica: una pianificazione cron per le mattine feriali

1. Trascina un trigger Scheduled su un grafo vuoto; deve essere l'unico trigger del grafo.
2. Imposta Frequency su Cron.
3. Digita 0 9 * * 1-5 (09:00, dal lunedì al venerdì) nel campo cron expression.
4. Imposta Timezone sul tuo, per esempio Europe/Istanbul, così le 09:00 indicano la tua mattina locale e non l'orologio del server.
5. Aggiungi almeno un nodo di azione dopo di esso (un trigger da solo non supera Validate), poi esegui Validate e Activate.
6. La prima attivazione arma la prossima occorrenza della pianificazione invece di scattare subito; da lì in poi scatta ogni mattina corrispondente senza che tu debba più intervenire.

Guida pratica: un webhook con firma verificata

1. Trascina un trigger Incoming webhook, inserisci una lunga stringa casuale come HMAC secret e conservane una copia in un luogo sicuro; non c'è modo di rivelare un segreto dimenticato in seguito, solo di sovrascriverlo con uno nuovo.
2. Aggiungi almeno un'azione dopo di esso, esegui Validate, poi Activate; l'URL in ingresso accetta chiamate solo quando lo stato dell'automazione è Active.
3. Trova l'id dell'automazione (vedi sopra) e fornisci al sistema che invia l'URL /api/workflow/hook/<id>, con l'istruzione di firmare il corpo JSON grezzo della richiesta con il tuo segreto e inviarlo come X-Signature: sha256=<hex hmac>.
4. Se il sistema che invia ha una funzione "send test event", usala; altrimenti invia una richiesta a mano e controlla la vista Activity per una nuova esecuzione invece di aspettare un evento reale.

Guida pratica: far scattare un trigger dal tuo codice

1. Qualsiasi tipo di trigger può essere avviato tramite il ponte generico degli eventi: un POST autenticato a /api/workflow/events con un corpo come { "triggerType": "trigger.asset_uploaded", "payload": { "assetId": "..." } }.
2. È lo stesso percorso che il hook Design updated dell'app usa internamente, quindi è un modo collaudato per collegare un evento che l'editor integrato non fa ancora scattare automaticamente.
3. Una sola chiamata fa scattare ogni automazione ATTIVA della tua area di lavoro il cui trigger corrisponde a quel tipo, ciascuna con la propria esecuzione indipendente inizializzata con il tuo payload come contesto di partenza.

Risoluzione dei problemi

• L'evento del mio trigger è accaduto ma nessuna esecuzione è partita. Oggi solo Design updated è collegato per scattare automaticamente dall'app stessa. Gli altri trigger di eventi di design e area di lavoro sono pienamente funzionanti una volta scattati, ma per ora nulla nell'app li chiama al di fuori di una tua integrazione tramite il ponte degli eventi visto sopra. Usa Test per eseguire il grafo a prescindere dal trigger mentre aspetti quel collegamento.
• L'automazione è Active ma una chiamata webhook riceve 404. Verifica che lo stato sia davvero Active, non Paused o Draft, dato che solo un'automazione Active risolve il suo URL webhook, e ricontrolla che l'id nell'URL sia esatto.
• Una chiamata webhook riceve 401. Il trigger ha un HMAC secret configurato e la firma della chiamata non è stata inviata oppure non corrispondeva. La firma viene calcolata sull'esatto corpo grezzo della richiesta, quindi riformattare o riserializzare il JSON prima di firmarlo romperà il controllo anche se il contenuto sembra identico.
• L'evento scatta ma un'esecuzione non parte ogni volta. Controlla nelle Settings dell'automazione una finestra di Debounce, e il campo debounce del nodo trigger stesso (sui trigger di eventi); l'uno o l'altro scarta silenziosamente uno scatto che cade entro il cooldown dopo il precedente.
• Un'automazione pianificata resta silenziosa durante certe ore. Controlla nelle Settings le Quiet hours; un trigger che altrimenti scatterebbe dentro quella finestra (nel fuso orario dell'automazione stessa) viene rimandato invece di essere scartato o messo in coda, quindi non scatterà retroattivamente alla fine della finestra.
• Due automazioni condividono un tipo di trigger e ne è partita solo una. È previsto se solo una era Active, oppure se il filtro per tag/cartella dell'altra sul nodo trigger non corrispondeva a questo particolare evento.

Consigli

Un trigger per grafo

La validazione segnala un grafo con zero trigger o con più di uno; tienine esattamente uno.

I webhook scattano solo mentre l'automazione è attiva

Una chiamata di incoming webhook a un'automazione Paused o Draft viene ignorata. Attivala prima.

Correlati

• Creare un flusso di lavoro
• Nodi
• Esecuzione e monitoraggio