Condizioni, smistamenti e ritardi
Fai dividere un flusso con Se / altrimenti e Smista, fallo attendere, cerca record, scorri gli elenchi e chiedi una decisione
Ultimo aggiornamento il
Con i passaggi del gruppo Logica decidi in quale direzione va un flusso e quando: il "se" e il "aspetta un momento". Un esempio: se dopo una settimana la fattura è ancora aperta, crea un'attività. Questi passaggi guidano le azioni successive. Solo Chiedi una decisione crea qualcosa da sé, un'attività.
| Passaggio | Cosa fa | Uscite |
|---|---|---|
| Se / altrimenti | Divide in base a condizioni | Sì, No |
| Smista | Sceglie un ramo in base al valore di un campo | Una per ramo e Predefinito |
| Ritardo | Attende un tempo fisso o fino a una data | Avanti |
| Aperto ora? | Controlla se in questo momento sei aperto | Aperto, Chiuso |
| Attendi l'apertura | Attende il prossimo orario di apertura | Avanti |
| Attendi la chiusura | Attende il prossimo orario di chiusura | Avanti |
| Al massimo una volta per periodo | Blocca le ripetizioni | Continua, Già eseguito |
| Cerca un record | Recupera un record con il suo ID | Trovata, Non trovata |
| Per ogni | Esegue i passaggi successivi per ogni elemento di un elenco | Per ogni, Completato |
| Attendi finché | Attende finché le condizioni sono soddisfatte | Soddisfatto, Scaduto |
| Attendi un evento | Attende che in Tillor succeda qualcosa | Ricevuto, Scaduto, a volte Eliminato |
| Chiedi una decisione | Fa scegliere a un collega tra le tue opzioni | Una per opzione e Scaduto |
Se / altrimenti
Divide il flusso in due strade in base ai dati. Il principio è lo stesso del filtro Solo quando del trigger, ma qui è a metà del flusso.
Il passaggio ha due uscite: Sì (le condizioni sono soddisfatte) e No (non lo sono).
- Aggiungi un passaggio Se / altrimenti
- In Condizioni fai clic su Aggiungi condizione
- Scegli il campo con il pulsante Variabile, oppure digita tu il percorso, per esempio
invoice.paymentStatus - Scegli il confronto (è, non è, contiene, è maggiore di, è minore di, è uno tra, è vuoto o non è vuoto) e inserisci il valore
- Collega l'uscita Sì ed eventualmente No a un passaggio successivo
Un passaggio Se / altrimenti ha bisogno di almeno una condizione. Altrimenti Tillor segnala Aggiungi una condizione. Con più condizioni scegli tra Devono corrispondere tutte e Ne basta una. I confronti funzionano come descritto in Solo quando.
Non devi collegare entrambe le uscite. Se un'uscita non porta da nessuna parte, l'esecuzione finisce lì. Un flusso che fa qualcosa solo con Sì va quindi benissimo.
Puoi usare anche i campi dei passaggi precedenti. Dopo una Richiesta API puoi per esempio controllare response.status o response.data.paymentStatus.
Smista
Scegli Smista quando ti servono più di due strade. Il passaggio guarda il valore di un campo e sceglie il ramo corrispondente.
- In Campo scegli il campo da controllare, per esempio
occupation.occupationType - In Rami fai clic su Aggiungi ramo. Compila Ramo (il nome che appare sull'uscita) e Uguale a (il valore che il campo deve avere)
- Ripeti per ogni ramo
- Collega ogni uscita a un passaggio successivo
Ogni ramo ha una propria uscita sotto il passaggio. In più c'è sempre un'uscita Predefinito, usata quando nessun ramo corrisponde.
- Il campo deve corrispondere esattamente al valore, maiuscole incluse
- Se corrisponde più di un ramo, vince il primo dell'elenco
- Un ramo senza valore in Uguale a non conta
- Puoi impostare al massimo 8 rami, più Predefinito
- Se il campo è vuoto o non esiste, il flusso passa da Predefinito
I valori dei campi a scelta sono nella notazione di Tillor. Un'occupazione di tipo caravan a noleggio ha per esempio il valore RENTAL_CARAVAN, una fattura pagata PAID.
L'elenco in Campo mostra i campi dell'evento e dei passaggi precedenti. I campi della risposta di una richiesta API compaiono nell'elenco solo quando Tillor conosce un esempio di quella risposta. Vedi Usare una risposta API.
Ritardo
Con Ritardo fai attendere il flusso prima che prosegua. Lo usi per cose come riguardare tra una settimana.
In Attendi scegli uno dei due modi.
Per un tempo fisso
Scegli Per un tempo fisso e in Durata inserisci un numero e un'unità: secondi, minuti, ore, giorni o settimane. I secondi non sono esatti. Il flusso può proseguire qualche secondo più tardi.
Un ritardo di 0 non fa nulla, perciò Tillor segnala Un ritardo di 0 non fa nulla.
Fino a una data
Scegli Fino a una data quando il tempo di attesa dipende da una data presente nei dati, come la scadenza di una fattura o la data di fine di una prenotazione.
| Campo | Cosa inserisci |
|---|---|
| Data | Un campo con una data, per esempio invoice.dueDate. L'elenco mostra solo i campi che sono una data |
| Rispetto a quella data | Prima o Dopo |
| Scarto | Quanto tempo prima o dopo quella data, in minuti, ore, giorni o settimane. Con 0 il flusso prosegue esattamente in quella data |
Esempi:
- Data
invoice.dueDate, Dopo, Scarto 1 giorno: il flusso prosegue un giorno dopo la scadenza - Data
reservation.checkIn, Prima, Scarto 2 giorni: il flusso prosegue due giorni prima dell'arrivo
Se quel momento è già passato, o la data è vuota, il flusso prosegue subito.
Cosa succede durante l'attesa
- L'esecuzione ottiene lo stato In attesa. Nella scheda Esecuzioni vedi quando prosegue (Riprende …). Le attese lunghe, come le settimane, non sono un problema
- Dopo il ritardo Tillor rilegge i dati, così i passaggi successivi vedono la situazione attuale. Vedi sotto
- Se metti in pausa l'automazione durante l'attesa, l'esecuzione si ferma appena il tempo di attesa è finito. Non prosegue e ottiene lo stato Annullata. Se riattivi l'automazione prima che il tempo di attesa sia finito, l'esecuzione prosegue normalmente
- Se elimini l'automazione, le esecuzioni in attesa si interrompono
- Se modifichi il flusso mentre un'esecuzione è in attesa, quell'esecuzione termina con il flusso com'era quando è partita
I dati vengono riletti
Un'esecuzione ricorda i dati del momento dell'evento, ma rilegge i record collegati prima di proseguire. Sono il record dell'evento (per esempio la fattura) e i record a cui rimanda (per esempio il cliente).
Un esempio: un'automazione invia un promemoria per una fattura, attende 7 giorni e poi controlla con Se / altrimenti che invoice.paymentStatus non sia PAID. Se la fattura è stata pagata in quella settimana, la condizione vede la fattura pagata e il flusso passa da No.
Ci sono due eccezioni:
- Se il record non esiste più, per esempio perché un'occupazione è stata eliminata, l'esecuzione tiene la copia del momento dell'evento
- I dati prodotti da un passaggio precedente, come la risposta di una richiesta API, non vengono recuperati di nuovo. Se vuoi quei dati aggiornati dopo un ritardo, fai una nuova richiesta API
In una prova non viene riletto nulla
Un'esecuzione di prova salta i ritardi e lavora con i dati di esempio che inserisci tu. Cosa succede dopo un vero ritardo lo vedi solo in un'esecuzione reale.
Aperto ora?
Controlla se la tua organizzazione è aperta in questo momento e divide il flusso in Aperto e Chiuso. Non c'è nulla da impostare. Tillor usa gli orari in Impostazioni > Orari di apertura, con periodi stagionali, festività ed eccezioni. Vedi Impostazioni dell'organizzazione.
Usalo per esempio per inviare un testo diverso o creare un'attività fuori orario. Se preferisci aspettare di essere di nuovo aperto, usa Attendi l'apertura. Se vuoi aspettare la chiusura, usa Attendi la chiusura.
Attendi l'apertura
Mette in pausa il flusso fino al prossimo orario di apertura e poi prosegue. La tua organizzazione è già aperta? Allora il flusso prosegue subito. Non c'è nulla da impostare.
- L'orario di apertura viene da Impostazioni > Orari di apertura, nel fuso orario della tua organizzazione
- Se nel prossimo mese non c'è nessun orario di apertura, il flusso prosegue subito invece di restare in attesa
- Durante l'attesa l'esecuzione ottiene lo stato In attesa. Cosa succede in quel momento è descritto in Ritardo
Attendi la chiusura
Mette in pausa il flusso fino al prossimo orario di chiusura e poi prosegue. La tua organizzazione è già chiusa? Allora il flusso prosegue subito. Non c'è nulla da impostare.
- L'orario di chiusura viene da Impostazioni > Orari di apertura, nel fuso orario della tua organizzazione
- I blocchi consecutivi, come 9:00–12:00 e 12:00–17:00, contano come un unico tratto. Il flusso attende la fine di quel tratto
- Durante l'attesa l'esecuzione ottiene lo stato In attesa. Cosa succede in quel momento è descritto in Ritardo
Al massimo una volta per periodo
Lascia passare il flusso solo se per lo stesso record non ha ancora superato questo passaggio nel periodo indicato. In questo modo non invii ogni giorno lo stesso promemoria a un cliente.
| Campo | Cosa inserisci |
|---|---|
| Periodo | Per quanto tempo contano le esecuzioni precedenti, in minuti, ore, giorni o settimane. Predefinito 1 giorno |
| Per | Su cosa conti. Vuoto significa per record con cui è partito il flusso, come la fattura o la prenotazione. Inserisci una variabile, per esempio {customer.id}, per contare per cliente o per area |
Il passaggio ha due uscite: Continua se nel periodo il flusso non è ancora passato di qui, e Già eseguito se invece è già passato. Collega Già eseguito a un altro passaggio, oppure lascialo vuoto così l'esecuzione finisce lì.
Tieni presente che:
- Contano solo le esecuzioni della stessa automazione, e solo se sono passate da questo passaggio tramite Continua
- Se non colleghi Eliminato a nulla, Tillor ferma i flussi in attesa di quel record ed elimina le attività che il flusso ha creato e che solo il flusso poteva completare. Se colleghi l'uscita, il flusso prosegue da lì
- Se il flusso parte senza record, per esempio con Ogni giorno a un'ora, inserisci tu una variabile in Per. Senza quel valore ogni esecuzione è nuova e il passaggio non blocca nulla
- L'esecuzione in corso non conta a sua volta
Un esempio: Periodo 7 giorni e Per {invoice.customerId} lasciano passare al massimo un promemoria alla settimana per cliente, anche se quel cliente ha più fatture scadute.
Cerca un record
Carica un record in base al suo ID, così i passaggi successivi possono usarne i campi. È utile quando l'evento fornisce solo un ID, come il messaggio in una conversazione della inbox.
| Campo | Cosa inserisci |
|---|---|
| Tipo di record | Cliente, Prenotazione, Occupazione, Fattura, Pagamento, Terreno, Attività, Documento, Mezzo di accesso, Tag NFC, Contatore, Conversazione della inbox o Messaggio della inbox. Predefinito Messaggio della inbox |
| ID | L'ID del record, per esempio {messageId}. Obbligatorio |
Il passaggio ha due uscite: Trovata e Non trovata. Se il record non esiste o l'ID è vuoto, il flusso passa da Non trovata.
Dopo Trovata i campi del record sono in variabili che iniziano con found seguito dal tipo: {foundCustomer.firstName}, {foundInvoice.displayId}, {foundReservation.checkIn}, {foundTerrain.name}, {foundInboxMessage.direction}. Gli altri tipi si chiamano foundOccupation, foundPayment, foundTask, foundAccessMethod, foundNfcTag, foundMeter e foundInboxThread. Ci sono anche i record a cui rimanda, un livello più in profondità, come {foundReservation.customer.firstName}. Trovi tutto nell'elenco dietro il pulsante Variabile.
Una seconda ricerca dello stesso tipo sostituisce la prima. Attenzione con Attività: usa lo stesso nome foundTask di Cerca attività, e vince l'ultimo dei due. Lo stesso vale per Documento e foundDocument di Trova documento.
Mappa variabili
Copia valori in nuovi nomi di variabile, così i passaggi successivi possono usare un'unica forma. È comodo quando un flusso parte sia con Webhook in entrata ({body.…}) sia con Fattura scaduta ({invoice.…}).
| Campo | Cosa inserisci |
|---|---|
| Mapping | Righe con Variabile destinazione (es. invoice) e Fonte (es. {foundInvoice} o {body.invoiceId}) |
Il passaggio ha un'uscita: Avanti. Se la fonte è esattamente una variabile tra parentesi graffe, per esempio {foundInvoice}, Tillor copia l'intero record (oggetto). Altrimenti Tillor compila la fonte come testo, come Fattura {foundInvoice.displayId} in meta.label.
Un test tipico con webhook: Webhook in entrata → Cerca un record (Fattura, ID {body.invoiceId}) → Mappa variabili (invoice ← {foundInvoice}) → le stesse condizioni e la stessa approvazione del trigger schedule.
Esegui codice
Esegue un pezzo di TypeScript sulle variabili del flusso e conserva ciò che restituisce come nuova variabile. Serve per la logica che non entra in campi e condizioni: quali sottoattività devono comparire, calcolare un importo o una data, rimodellare il corpo di un webhook.
| Campo | Cosa inserisci |
|---|---|
| Codice | TypeScript. Le variabili si scrivono come nei testi, con le parentesi graffe: {customer.firstName} viene letta come valore, non inserita come testo. Chiudi con return. Obbligatorio |
| Variabile di output | Il nome con cui i passaggi successivi leggono il risultato, come result (poi {result}) o result.names. Predefinito result |
Il passaggio ha un'uscita: Avanti. Funziona così:
- Il codice vede solo le variabili che nomina. Una variabile che il flusso non ha è
null; una data arriva come testo (2026-07-01T10:00:00.000Z) - Formattazioni e spostamenti di data (
{bedrag|currency},{datum + 1 day}) qui non funzionano: calcolali nel codice - Restituisci un elenco, un testo, un numero o un oggetto. Un oggetto lo leggi poi campo per campo:
{result.total} - Il codice non può recuperare né inviare nulla: niente internet, niente database. Si limita a calcolare. Se calcola troppo a lungo (più di 50 ms) viene interrotto
- Se il codice genera un errore, l'esecuzione si ferma con quell'errore e il numero di riga. Li vedi nella scheda Esecuzioni
- A destra del codice vedi subito cosa restituisce sull'esempio; durante la prova viene eseguito anche lui
Un esempio: dopo la partenza vuoi sottoattività che dipendono dal terreno. Metti un passaggio Esegui codice con:
const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;Poi in Crea attività compila il campo Sottoattività solo con {result}: ogni testo dell'elenco diventa una sottoattività.
Per ogni
Esegue i passaggi dopo Per ogni una volta per ogni elemento di un elenco, per esempio per ogni fattura aperta di un cliente. Il flusso stesso prosegue da Completato.
| Campo | Cosa inserisci |
|---|---|
| Elenco | Metodi di accesso di un cliente, Tag NFC di un cliente, Fatture aperte di un cliente, Prenotazioni confermate di un cliente, Occupazioni di un cliente, Documenti di un cliente (solo quelli attivi) o Contatori di un terreno. Predefinito Metodi di accesso di un cliente |
| Da | Il cliente o il terreno di cui vuoi l'elenco, per esempio {customer.id} o {occupation.terrainId}. Obbligatorio |
Il passaggio ha due uscite con un significato proprio:
- Per ogni porta ai passaggi che vuoi eseguire per ogni elemento
- Completato è la strada con cui prosegue il flusso stesso
Funziona così:
- Ogni elemento ha una propria esecuzione, che percorre i passaggi dopo Per ogni fino alla fine di quel ramo. Le vedi nella scheda Esecuzioni, che mostra solo le ultime 20
- L'elemento è nella variabile
item, per esempio{item.id}. Le variabili dell'evento e dei passaggi precedenti restano disponibili - Il flusso non aspetta che gli elementi siano finiti. Subito dopo averli avviati, prosegue da Completato. Il risultato di un elemento non puoi quindi usarlo nei passaggi dopo Completato
- Vengono elaborati al massimo 100 elementi, i più vecchi per primi. Se nell'elenco ce ne sono di più, gli altri non vengono elaborati
- Se l'elenco è vuoto o il campo Da è vuoto, non parte nulla e il flusso prosegue subito da Completato
- Le Fatture aperte di un cliente sono fatture contabilizzate di cui è ancora aperto qualcosa. Le Prenotazioni confermate di un cliente sono prenotazioni con lo stato Prenotato
Un esempio: una fattura scade e vuoi creare un link di pagamento per ogni fattura aperta di quel cliente. Scegli Fatture aperte di un cliente, inserisci {invoice.customerId} in Da e dopo Per ogni metti un passaggio Crea link di pagamento con {item.id} come fattura.
Attendi finché
Controlla le condizioni ogni volta di nuovo finché sono soddisfatte, oppure si ferma dopo un certo tempo. Usalo quando non sai quando succederà qualcosa ma sai cosa aspetti, per esempio che una fattura sia pagata.
| Campo | Cosa inserisci |
|---|---|
| Finché | Una o più condizioni, nello stesso modo di Se / altrimenti |
| Controlla ogni | Ogni quanto Tillor ricontrolla, in minuti, ore, giorni o settimane. Almeno 5 minuti. Predefinito 1 ora |
| Smetti di attendere dopo | Per quanto tempo al massimo il passaggio attende. Predefinito 7 giorni |
Il passaggio ha due uscite: Soddisfatto (le condizioni sono soddisfatte) e Scaduto (il tempo di attesa è finito senza che lo fossero).
Tieni presente che:
- Il primo controllo avviene subito. Se le condizioni sono già soddisfatte, il flusso prosegue direttamente da Soddisfatto. Se non hai inserito nessuna condizione, è sempre soddisfatta
- A ogni controllo Tillor rilegge i record dell'evento, come per un ritardo. Una condizione come
invoice.paymentStatusèPAIDvede quindi il pagamento non appena c'è - Un intervallo inferiore a 5 minuti diventa 5 minuti
- Durante l'attesa l'esecuzione ottiene lo stato In attesa. Per mettere in pausa e modificare il flusso vale lo stesso di Ritardo
Attendi un evento
Mette in pausa il flusso finché in Tillor succede qualcosa, per esempio che la fattura sia pagata.
| Campo | Cosa inserisci |
|---|---|
| Evento | Quello che aspetti. Lo stesso elenco del trigger. Obbligatorio |
| Solo per lo stesso record | Prosegue solo se l'evento riguarda il record con cui è partito il flusso. Predefinito attivo |
| Smetti di attendere dopo | Per quanto tempo al massimo il passaggio attende. Predefinito 7 giorni |
Il passaggio ha due uscite: Ricevuto (l'evento è arrivato) e Scaduto (il tempo di attesa è finito senza evento). Se Solo per lo stesso record è attivo, si aggiunge una terza uscita, Eliminato. La usi quando il record del flusso è stato eliminato mentre il flusso attendeva.
Tieni presente che:
- Con Solo per lo stesso record attivo conta per esempio solo il pagamento della fattura con cui è partito il flusso. Se lo disattivi, ogni evento di quel tipo fa proseguire il flusso
- Se non colleghi Eliminato a nulla, Tillor ferma i flussi in attesa di quel record ed elimina le attività che il flusso ha creato e che solo il flusso poteva completare. Se colleghi l'uscita, il flusso prosegue da lì
- Se il flusso parte senza record, per esempio con Ogni giorno a un'ora, conta ogni evento di quel tipo
- Conta anche un evento causato da un passaggio di un'automazione stessa. I flussi in attesa proseguono quindi anche per il lavoro di Flusso di lavoro
- Dopo Ricevuto i dati dell'evento che aspettavi sono nelle variabili, senza il collega che lo ha causato. Se aspetti
invoice:paid,{invoice.paymentStatus}dà poi il nuovo stato - Durante l'attesa l'esecuzione ottiene lo stato In attesa. Per mettere in pausa e modificare il flusso vale lo stesso di Ritardo
Chiedi una decisione
Crea un'attività con pulsanti che definisci tu e attende che qualcuno scelga un pulsante. Così inserisci un momento in cui una persona controlla, per esempio prima che il flusso blocchi un cliente o contabilizzi una fattura. Ogni opzione è un pulsante sull'attività e un'uscita del passaggio.
| Campo | Cosa inserisci |
|---|---|
| Titolo dell'attività | Il titolo dell'attività. Obbligatorio |
| Descrizione | Di' al tuo collega cosa deve essere deciso |
| Opzioni | I pulsanti sull'attività. Vedi sotto. Almeno una |
| Assegna a | Scegli uno o più colleghi |
| Assegna a gruppi | Scegli uno o più gruppi |
| Collega a | I record presso cui compare l'attività, come il cliente o la fattura. Precompilato con i record noti a questo passaggio |
| Smetti di attendere dopo | Per quanto tempo al massimo il passaggio attende. Predefinito 3 giorni |
Impostare le opzioni
- In Opzioni fai clic su Aggiungi opzione e inserisci il nome, per esempio Approva. Quel nome compare sul pulsante e sull'uscita
- Fai clic sul riquadro colorato a sinistra del nome (Icona e colore) per scegliere un colore e un'icona. L'icona non è obbligatoria
- Attiva Chiedi una nota se il collega deve indicare un motivo con questa scelta
- Attiva Chiedi conferma se il collega deve prima confermare. Compili allora un Titolo conferma e un Messaggio di conferma e scegli in Gravità tra Info, Avviso o Destructive. In questi testi puoi usare variabili
- Ripeti per ogni opzione. Puoi creare al massimo 8 opzioni
Se l'elenco è ancora vuoto, il pulsante Approva / Rifiuta prepara subito due opzioni: un Approva verde e un Rifiuta rosso. Ogni opzione ha bisogno di un nome, altrimenti Tillor segnala Ogni opzione ha bisogno di un nome. Senza opzioni Tillor segnala Aggiungi almeno un'opzione.
Uscite
Il passaggio ha un'uscita per opzione, con il nome e il colore di quell'opzione, più sempre Scaduto.
| Uscita | Quando |
|---|---|
| Il nome di un'opzione | Qualcuno ha scelto quel pulsante sull'attività |
| Scaduto | Il tempo di attesa è finito senza scelta, oppure l'attività è stata eliminata |
Tieni presente che:
- I pulsanti sono sulla scheda dell'attività, nell'elenco delle attività e nell'attività stessa. Un'attività così non ha la spunta: non puoi semplicemente completarla, solo scegliere un pulsante. Dopo la scelta l'attività è su Completata e viene indicato quale opzione è stata scelta. Vedi Attività con pulsanti di scelta
- Può scegliere chi è assegnato all'attività, anche tramite un gruppo, e gli amministratori. Se non assegni nessuno, può scegliere chiunque veda l'attività
- L'attività ottiene priorità Alta. È a nome di Flusso di lavoro
- Se l'attività viene eliminata prima che qualcuno scelga, il flusso prosegue da Scaduto. Dopo Scaduto per il tempo di attesa l'attività resta
- I passaggi successivi possono usare
{approvalTask.id},{approval.decision},{approval.label},{approval.note}e{approval.decidedBy.name}.{approval.label}è il nome dell'opzione scelta e{approval.note}la nota che il collega ha inserito - Durante l'attesa l'esecuzione ottiene lo stato In attesa. Per mettere in pausa e modificare il flusso vale lo stesso di Ritardo
In una prova scegli tu l'uscita
Un'esecuzione di prova non può sapere se sei aperto, cosa decide un collega e se un record esiste. In Cosa succede in questi passaggi? scegli quindi tu l'uscita di Aperto ora?, Al massimo una volta per periodo, Cerca un record, Per ogni, Attendi finché, Attendi un evento e Chiedi una decisione. Con Per ogni la prova percorre l'uscita che scegli, Per ogni o Completato, non entrambe.
Cosa succede dopo?
- Un'uscita che non colleghi fa finire l'esecuzione lì.
- Con un passaggio di attesa l'esecuzione ottiene lo stato In attesa e prosegue più tardi. Un'automazione in pausa ferma le esecuzioni in attesa appena il tempo di attesa è finito.
- Dopo un tempo di attesa Tillor rilegge i dati, così i passaggi vedono la situazione attuale.