Condizioni, rami e ritardi

I trigger avviano un'automazione e le azioni svolgono il lavoro. I passaggi di questo articolo decidono che cosa accade nel mezzo: quale percorso prende un membro, quando viene eseguito il passaggio successivo e con quali dati lavorano i passaggi seguenti.

Apra le automazioni

Dove trovare questi passaggi

Nell'editor, apra la libreria e passi alla scheda Azioni. I passaggi di questo articolo si trovano in alto in una sezione propria, chiamata Controllo. Ne trascini uno sul canvas o ci clicchi, poi lo colleghi come qualsiasi altro passaggio.

Alcune regole valgono per ogni passaggio:

• L'ingresso si trova a sinistra e le uscite a destra. I passaggi con più di un'uscita etichettano ogni uscita, per esempio Sì e No.
• Ogni ingresso accetta un solo collegamento. Se traccia una seconda linea nello stesso ingresso, questa sostituisce la prima. Per riunire due percorsi, usi Unisci.
• Una linea non può tornare a un passaggio precedente. L'editor non Le permette di tracciarla. Per ripetere dei passaggi, usi Ciclo.
• Un'uscita a cui non è collegato nulla termina semplicemente quel percorso.

Clicchi su un passaggio per aprirne le impostazioni a destra. I campi contrassegnati con una stella sono obbligatori. Quando la configurazione di un passaggio ha un problema, l'editor lo segna con un avviso giallo.

Creare un'automazione

Verificare regole: Condizione, Filtro e Confronta

Come funzionano le regole

Condizione e Filtro verificano un elenco di regole. Ogni regola ha una chiave, un operatore e un valore. Aggiungi regola ne aggiunge una, e la croce accanto alla chiave la rimuove.

La chiave dice che cosa guardare:

• Un campo dei dati che l'automazione porta con sé, per esempio email o un campo fornito dal trigger.
• member. seguito da un campo membro, per esempio member.email o member.first_name.
• member.cf_ seguito dall'ID di un campo personalizzato. Legge il valore così com'è salvato: per un campo a scelta è il valore dell'opzione, non la sua etichetta, e un campo data restituisce la data salvata. Un campo senza valore conta come vuoto.
• member.tags o member.groups. Gli operatori diventano ha e non ha, e il tag o il gruppo si sceglie da un elenco.
• Un valore di interazione con le email, per esempio email.opened_automation (1 quando il membro ha aperto un'email di questa automazione, altrimenti 0), email.opened_this_step (un'email del passaggio email più vicino prima di questo), email.opened_ever, email.opened_days_ago o email.opens_7d. Gli stessi valori esistono per i clic, per esempio email.clicks_30d.

Il campo della chiave li suggerisce mentre digita, compresi i Suoi campi personalizzati per nome. Scegliendone uno vengono inseriti member.cf_ e l'ID, e sotto la regola un suggerimento nomina il campo, per esempio "Campo personalizzato: Plan".

Gli operatori sono è uguale a, non è uguale a, contiene, non contiene, in (elenco separato da virgole), non in (elenco separato da virgole), è vuoto, non è vuoto e i confronti numerici >, ≥, < e ≤. Tenga presente:

• è uguale a confronta i valori come testo.
• contiene cerca il valore all'interno del testo e distingue tra maiuscole e minuscole.
• in (elenco separato da virgole) accetta più valori separati da virgole, per esempio gold, silver, ed è soddisfatto quando la chiave corrisponde a uno di essi.
• I confronti numerici sono soddisfatti solo quando entrambi i lati sono numeri.

Corrispondenza decide come si combinano le regole: Tutte le regole devono essere soddisfatte o Almeno una regola è soddisfatta.

Condizione

Condizione manda il membro verso una di due uscite, Sì quando le regole sono soddisfatte e No quando non lo sono. Senza regole, ogni esecuzione prende l'uscita Sì, e il passaggio mostra Sempre sì.

La usi per vere decisioni tra due alternative, per esempio un'email di benvenuto per i nuovi clienti e una diversa per i clienti che ritornano.

Filtro

Filtro ha una sola uscita. In Mantieni se imposta le regole, e Corrispondenza funziona come sopra. Quando le regole sono soddisfatte, il percorso prosegue. Quando non lo sono, il percorso si ferma a questo passaggio e il passaggio conta come saltato nell'esecuzione. Senza regole, passa tutto.

Usi Filtro quando conta un solo esito, per esempio "proseguire solo per i membri del gruppo Premium".

Confronta

Confronta verifica esattamente due valori l'uno rispetto all'altro:

• Primo valore (obbligatorio) e Secondo valore accettano ciascuno un nome di campo dei dati, member. più un campo membro, member.cf_ più l'ID di un campo personalizzato, un valore email come email.opens_7d, un segnaposto come {{score}}, oppure un valore fisso come 10. Questo campo non dà suggerimenti. L'ID di un campo personalizzato è quello del suo segnaposto {cf_…}, veda Trigger e azioni.
• Operatore offre è uguale a, non è uguale a, contiene, maggiore di, maggiore o uguale, minore di e minore o uguale.

Le uscite sono Corrispondenza e Nessuna corrispondenza.

Dividere e riunire percorsi: Dividi e Unisci

Dividi

Dividi apre il flusso in più percorsi. Numero di rami imposta da 2 a 5 uscite, etichettate Via 1, Via 2 e così via. Ogni percorso riceve gli stessi dati e viene eseguito per conto proprio. Un ritardo su un percorso trattiene solo quel percorso.

Unisci

Unisci riunisce i percorsi. Numero di percorsi in ingresso imposta da 2 a 5 ingressi. Continua quando decide come si comporta:

• Ogni percorso prosegue autonomamente è l'impostazione predefinita. Ogni percorso che arriva prosegue da solo attraverso i passaggi dopo Unisci, quindi quei passaggi vengono eseguiti una volta per ogni percorso.
• Tutti i percorsi sono arrivati attende che un percorso sia arrivato su ogni ingresso collegato, poi prosegue una volta. I dati di tutti i percorsi vengono combinati. Quando due percorsi portano lo stesso campo, vince il percorso arrivato per ultimo. L'attesa copre anche i percorsi che contengono un Ritardo o un Attendi fino alla data.

Se un percorso non arriva mai, per esempio perché un Filtro lo ha fermato o una Condizione ha mandato il membro altrove, Unisci prosegue con i percorsi che sono arrivati non appena nient'altro nell'esecuzione è ancora in corso o in attesa.

Attendere: Ritardo e Attendi fino alla data

Ritardo

Ritardo mette in pausa il percorso per un tempo fisso. Imposti Durata (almeno 1) e Unità: Minuti, Ore o Giorni. Un nuovo Ritardo parte da 1 ora. Se la durata è vuota, l'editor avvisa "Il ritardo non ha una durata."

Attendi fino alla data

Attendi fino alla data mette in pausa fino a una data che proviene dai dati:

• Campo data (obbligatorio) nomina il campo che contiene la data, per esempio renewal_date. Per un campo membro, anteponga member. al suo nome. Per un campo data personalizzato, scriva member.cf_ e l'ID del campo.
• Direzione dello scostamento, Sfalsato e Unità spostano il momento. Dopo la data (+) attende più a lungo, Prima della data (-) prosegue prima. Tre giorni prima di un rinnovo, per esempio, corrispondono a Prima della data (-) con 3 Giorni.

Se il momento è già passato, il percorso prosegue subito. Se il campo è vuoto o contiene qualcosa che non è una data, il percorso prosegue senza attendere, e il passaggio mostra una nota nell'esecuzione, per esempio "Nessuna data trovata in "renewal_date". Il flusso è proseguito senza attendere." Una data senza fuso orario viene letta nel fuso orario impostato per la Sua piattaforma.

Che cosa succede durante una pausa

Un Ritardo o un Attendi fino alla data non tiene occupato nulla. L'esecuzione memorizza dove si è fermata, e un processo in background la riprende quando è il momento. Mentre attende, la cronologia delle esecuzioni la mostra come In attesa con data e ora sotto Riprende. Quando apre l'esecuzione e clicca sul passaggio in attesa, la scheda Esecuzione mostra lo stesso.

Un'esecuzione in attesa prosegue con la versione con cui è partita, anche se nel frattempo pubblica una nuova versione. Se archivia o elimina l'automazione, le esecuzioni in attesa vengono annullate quando arriva il loro momento. Anche mettere in pausa l'automazione le annulla, tranne le esecuzioni di prova che ha avviato a mano.

Test e cronologia delle esecuzioni

Lavorare con i dati

Ogni esecuzione porta con sé dei dati: ciò che il trigger ha fornito più qualsiasi cosa abbiano aggiunto i passaggi precedenti. I tre passaggi seguenti modificano questi dati. I passaggi successivi possono usare ogni campo come segnaposto, per esempio {{discount_code}}.

Imposta campi

Imposta campi aggiunge campi o sovrascrive quelli esistenti. In Campi da impostare, ogni riga ha una chiave e un valore. Aggiungi aggiunge un'altra riga. I valori possono contenere segnaposto, per esempio Hello {{member.first_name}}.

Data e Ora

Data e Ora calcola una data e la memorizza in un campo. Non attende. Per attendere la data calcolata, lo faccia seguire da Attendi fino alla data.

• A partire da: Adesso o Una data già presente nei dati. Con la seconda opzione compare Campo data, che nomina il campo da cui partire: un campo dei dati, un campo membro come member.created_at, oppure member.cf_ e l'ID di un campo data personalizzato. Se quel campo è vuoto o illeggibile, il passaggio parte da adesso.
• Direzione (Nel futuro (+) o Nel passato (-)), Sfalsato e Unità (Minuti, Ore, Giorni, Settimane o Mesi) spostano la data.
• Formato resta vuoto per il formato standard 2026-10-22T14:30:00+02:00, oppure accetta un modello come Y-m-d per 2026-10-22 o d.m.Y per 22.10.2026.

Il passaggio calcola nel fuso orario impostato per la Sua piattaforma, lo stesso che usa Attendi fino alla data. Il formato standard termina con il suo scostamento, per esempio +02:00, così un Attendi fino alla data successivo legge lo stesso momento.

• Salva nel campo (obbligatorio) nomina il campo per il risultato. Parte come date.

Espressione

Espressione calcola un valore con una breve formula e lo memorizza in un campo.

• Espressione (obbligatorio) contiene la formula. payload sta per i dati e member per i campi del membro, per esempio payload["score"] * 2 o member["first_name"] ~ " " ~ member["last_name"]. Può calcolare con + - * /, confrontare con ==, > o <, combinare con and e or, scegliere con condition ? a : b, e unire testo con ~.
• Salva il risultato in (obbligatorio) nomina il campo per il risultato. Parte come result.

I dati sensibili del membro come la password non sono disponibili. Se la formula non può essere calcolata, il campo resta vuoto e l'esecuzione prosegue.

Ripetere passaggi: Ciclo

Ciclo esegue i passaggi che lo seguono una volta per ogni elemento di un elenco.

• Campo elenco (obbligatorio) nomina il campo che contiene l'elenco, per esempio items, oppure member.tags per i tag del membro.
• Salva ogni elemento come imposta il nome del campo per l'elemento corrente. Parte come item. La posizione viene memorizzata accanto come item_index, contando da 0.

Ciclo ha una sola uscita, e tutto ciò che viene dopo viene eseguito una volta per elemento. Non c'è un'uscita aggiuntiva per "dopo l'ultimo elemento". Se il campo è vuoto o non è un elenco, il percorso si ferma al ciclo.

Due limiti tengono sotto controllo le esecuzioni. Un ciclo gestisce al massimo 200 elementi e ignora il resto. E un'esecuzione esegue al massimo 500 passaggi prima di mettersi in pausa o terminare. Un ciclo su 200 elementi con tre passaggi dopo avrebbe bisogno di 600 passaggi, quindi l'esecuzione si ferma con un errore. Tenga brevi i cicli, oppure sposti il lavoro in un'automazione separata con Esegui workflow.

Richiamare un'altra automazione: Esegui workflow

Esegui workflow avvia un'altra automazione come passaggio e prosegue una volta che questa è terminata.

• Workflow (obbligatorio) elenca le Sue automazioni attive che hanno una versione pubblicata. L'automazione che sta modificando non è nell'elenco, perché un'automazione non può richiamare se stessa.
• Usa il risultato decide che cosa torna indietro: Ignoralo, mantieni i dati di questo flusso, Uniscilo ai dati di questo flusso o Salvalo in un campo. Per l'ultima opzione, Nome del campo imposta il campo. Se lo lascia vuoto, il risultato finisce in sub.

L'altra automazione parte dal suo trigger con i dati e il membro di questa esecuzione, qualunque tipo di trigger abbia, e compare nella propria cronologia delle esecuzioni. Il suo risultato sono i dati al suo passaggio Fine, oppure al suo ultimo passaggio completato se non ha un Fine. Se si mette in pausa a un Ritardo, questo flusso non attende: prende i dati raggiunti fino a quel momento, e l'altra automazione prosegue più tardi per conto proprio.

Quando qualcosa va storto:

• Se l'altra automazione non riesce, non ha una versione pubblicata o non esiste più, questo passaggio non riesce e con esso l'esecuzione.
• Se l'altra automazione è in pausa, questo flusso prosegue senza di essa, e il passaggio mostra una nota nell'esecuzione.
• Le automazioni possono richiamarsi a vicenda fino a cinque livelli di profondità. Oltre, il passaggio non riesce.
• Se non è selezionato nessun workflow, il percorso si ferma a questo passaggio. L'editor lo segnala in anticipo: "Nessun workflow selezionato in "Esegui workflow"."

Rispondere a un webhook: Rispondi al webhook

Rispondi al webhook è per le automazioni che partono con il trigger Webhook in entrata. Decide che cosa riceve il sistema chiamante.

• Stato HTTP offre 200 OK, 201 Created, 202 Accepted, 400 Bad Request, 404 Not Found e 500 Server Error.
• Corpo della risposta parte come { "ok": true } e può contenere segnaposto, per esempio { "ok": true, "code": "{{discount_code}}" }. Un corpo in JSON valido viene inviato come JSON, qualsiasi altra cosa come testo semplice.

Non appena questo passaggio segue il trigger Webhook in entrata nella versione pubblicata, una chiamata a quel webhook non si limita più ad avviare l'automazione in background. La chiamata attende mentre l'automazione viene eseguita, e la risposta parte una volta che l'esecuzione è terminata o ha raggiunto la sua prima pausa. Un passaggio su un percorso che il trigger webhook non raggiunge mai, per esempio dietro un altro trigger, non cambia nulla. Per questo il passaggio funziona solo prima di qualsiasi Ritardo o Attendi fino alla data. Se uno di questi viene prima, il chiamante riceve la risposta standard {"ok": true, "triggers_fired": 1}, e l'editor avvisa: "Rispondi al webhook viene eseguito dopo un passaggio di ritardo o di attesa. Chi chiama il webhook riceve invece la risposta predefinita."

Il passaggio non ha uscita, quindi nulla lo segue sul suo percorso. Gli altri percorsi, per esempio dopo un Dividi, continuano a essere eseguiti.

Trigger e azioni

Terminare un percorso: Fine

Fine ferma il percorso su cui si trova. Non ha impostazioni né uscita. Gli altri percorsi della stessa esecuzione proseguono, e l'esecuzione conta come completata una volta che sono tutti terminati.

Anche un percorso senza ulteriori collegamenti termina da solo. Fine rende visibile la fine sul canvas, e decide quali dati riceve un'automazione chiamante da Esegui workflow.

Articoli correlati

• Panoramica delle automazioni
• Creare un'automazione
• Trigger e azioni
• Test e cronologia delle esecuzioni