Trigger
Scegli quando parte un'automazione, anche in una data come l'arrivo, filtra i casi e limitala a una volta per record
Ultimo aggiornamento il
Il trigger è il momento di partenza di un'automazione: il "quando". Si trova in cima a ogni flusso, sotto il nome Quando succede questo. Un esempio: parte quando un'occupazione termina. Il trigger determina anche quali dati possono usare i passaggi successivi. Un flusso può avere più trigger. Ogni trigger avvia un'esecuzione a sé, con il proprio filtro. Ne aggiungi uno dall'elenco a sinistra. L'ultimo trigger non può essere eliminato.
Da cosa parte l'automazione
In Parte da scegli uno tra sette momenti di partenza.
| Scelta | Parte quando |
|---|---|
| Quando succede qualcosa | In Tillor avviene un evento, per esempio un'occupazione che termina o una fattura che viene pagata |
| Fattura scaduta | Una fattura contabilizzata è ancora aperta dopo la scadenza |
| Webhook in entrata | Un altro sistema invia un messaggio all'indirizzo dell'automazione |
| Viene scelta un’azione dell’attività | Qualcuno sceglie, su un'attività, un pulsante di scelta collegato a questa automazione |
| Si raggiunge una data | Si raggiunge una data di un record, eventualmente un po' prima o dopo. Per esempio un giorno prima dell'arrivo di una prenotazione |
| Ogni giorno a un'ora | È l'ora scelta di ogni giorno |
| In base a un'espressione cron | Tocca al programma che indichi |
Scegli quindi prima il tipo di momento di partenza e poi i dettagli. Se scegli un altro momento di partenza, i filtri in Solo quando vengono svuotati. Erano scritti per la scelta precedente e non sono più adatti.
Quando succede qualcosa
In Evento scegli cosa deve avviare l'automazione. Fai clic sul campo e digita per cercare, per esempio occupation o invoice. Gli eventi sono scritti con la notazione di Tillor, come occupation:ended: prima l'argomento, poi cosa è successo.
Questi sono gli eventi che ti servono più spesso:
| Evento | Parte quando |
|---|---|
occupation:ended | Un'occupazione termina |
reservation:created | Viene creata una prenotazione |
reservation:updated | Una prenotazione viene modificata |
customer:created | Viene creato un cliente |
customer:updated | Un cliente viene modificato |
invoice:created | Viene creata una fattura |
invoice:updated | Una fattura viene modificata |
invoice:paid | Una fattura è stata pagata |
payment:created | Arriva un pagamento |
task:created | Viene creata un'attività |
task:status-changed | Lo stato di un'attività cambia |
task:assigned | Un'attività viene assegnata a qualcuno |
task:action-chosen | Qualcuno sceglie un pulsante di scelta su un'attività |
integration-alarm:created | Un contatore genera un allarme |
comment:created | Viene pubblicato un commento |
document:created | Viene aggiunto un documento |
signatureRequest:updated | Una richiesta di firma viene aggiornata |
signatureRequest:completed | Tutti i firmatari di una richiesta di firma hanno firmato |
mandate-agreement:signed | Un cliente ha firmato un mandato SEPA |
mandate-agreement:activated | Un mandato SEPA è diventato attivo |
mandate-agreement:expired | Una richiesta di mandato SEPA è scaduta senza firma |
mandate-agreement:failed | L'attivazione di un mandato SEPA è stata rifiutata o non è riuscita |
productPriceChange:applied | Entra in vigore un prezzo di prodotto pianificato |
È la stessa lista dei webhook. Puoi quindi usare qualsiasi evento per cui Tillor può inviare un webhook. Alcuni eventi che si verificano molto spesso, come lo stato fisico delle barriere, la digitazione nella inbox, i log dei controller e la presenza dei veicoli, non sono nell'elenco.
Ti manca un evento?
Sotto il campo Evento c'è il link Manca un evento? Richiedilo. Vedi Richiedere un passaggio o un evento.
Quali dati ricevi
A quasi tutti gli eventi è associato un record, come un'occupazione, una fattura o un'attività. Quel record, più i record a cui rimanda, sono poi disponibili come variabili nei passaggi. Con occupation:ended puoi per esempio usare:
{occupation.terrain.name}per il nome del terreno{occupation.customer.firstName}per il nome del cliente{occupation.reservation.displayId}per il numero della prenotazione. Non ogni occupazione ha una prenotazione: in quel caso resta vuoto
Inoltre ci sono sempre {triggeredBy.name} e {triggeredBy.id}: il collega che ha causato l'evento. Se l'evento è stato causato dal sistema, per esempio da una sincronizzazione bancaria, questi campi sono vuoti.
Sotto le impostazioni del trigger c'è Dati forniti da questo evento. Qui vedi esattamente quali variabili puoi usare. Per un evento di cui i dati non sono descritti, Tillor dice che non c'è nulla da scegliere. Le variabili che digiti tu funzionano comunque. Vedi Variabili e modelli.
Viene scelta un’azione dell’attività
Alcune attività hanno pulsanti di scelta invece di una spunta, per esempio da Chiedi una decisione. Un pulsante può essere collegato a un'automazione. Con questo trigger l'automazione parte non appena qualcuno sceglie quel pulsante. Vedi anche Attività con pulsanti di scelta.
Il collegamento di un pulsante a un'automazione non si fa nell'editor dei flussi. Se ti serve, chiedilo all'amministratore Tillor o al supporto.
I passaggi ricevono i dati dell'attività, per esempio {task.name} e {task.id}, più {action.label} (il nome del pulsante scelto) e {note} (la nota inserita dal collega, se il pulsante la richiedeva). Sotto Dati forniti da questo evento vedi l'elenco completo.
Fattura scaduta
Questo trigger parte per ogni fattura che:
- è contabilizzata (le bozze e le fatture annullate non contano)
- non è una nota di credito
- ha ancora un importo aperto
- ha una scadenza precedente a oggi
Per ognuna di queste fatture parte un'esecuzione a sé. I dati della fattura e del cliente sono disponibili come {invoice.…}, per esempio {invoice.displayId}, {invoice.amountOutstanding} e {invoice.customer.firstName}.
Se disattivi Esegui una volta per record, l'automazione parte per la stessa fattura al massimo una volta al giorno finché è scaduta. Se la lasci attiva, parte esattamente una volta per fattura. Di solito è ciò che vuoi per un promemoria.
In Da sollecitare scegli da quanto tempo la fattura deve essere aperta, con la stessa regola dell'elenco delle fatture. Attiva Salta i clienti esclusi dai solleciti automatici per saltare i clienti che lo hanno impostato nelle loro impostazioni di fatturazione. Anche una fattura esclusa dai promemoria automatici non fa partire il flusso.
Webhook in entrata
Un webhook è un messaggio che un altro sistema invia a un indirizzo. Con questo trigger quel sistema avvia l'automazione, per esempio il tuo sito web, un modulo o una piattaforma di prenotazione. Ogni automazione ha un proprio indirizzo segreto.
- In Parte da scegli Webhook in entrata
- Salva l'automazione. In Indirizzo compare l'URL
- Fai clic su Copia e imposta l'indirizzo nell'altro sistema
- Attiva l'automazione
L'altro sistema invia una POST con JSON a quell'indirizzo. Il contenuto è poi disponibile come {body.…}, per esempio {body.email} o {body.reservering.nummer}, e i parametri nell'URL come {query.…}. Con Solo quando puoi filtrare anche su questi campi.
Per il resto funziona così:
- L'indirizzo è il segreto. Chi lo conosce può avviare l'automazione. Condividilo quindi solo con il sistema che ne ha bisogno
- Se l'indirizzo trapela, fai clic su Nuovo indirizzo e salva. Da quel momento il vecchio indirizzo non funziona più
- Un'automazione disattivata o un indirizzo sbagliato restituisce un errore
404 - Il contenuto può essere al massimo di 100 KB
- Ogni chiamata avvia un'esecuzione per ogni trigger webhook del flusso. L'indirizzo appartiene al primo trigger webhook. Nuovo indirizzo su quel trigger lo sostituisce
- Non è collegato nessun record, quindi Esegui una volta per record non ha effetto
Ignorare le ripetizioni
Se l'altro sistema a volte invia due volte la stessa chiamata, con Ignora le ripetizioni eviti che il flusso parta due volte. Tillor ricorda una chiave della chiamata. Se la stessa chiave arriva di nuovo, non parte nulla.
| Scelta | Cos'è la chiave |
|---|---|
| Ogni chiamata avvia il flusso | Non c'è nessuna chiave. Impostazione predefinita |
| Da un'intestazione | Il valore di un'intestazione che scegli in Nome dell'intestazione, per esempio Idempotency-Key |
| Dal corpo JSON | Il valore di un campo del JSON, che scegli in Campo, come id o data.eventId |
| Lo stesso corpo JSON | L'intero contenuto. Una chiamata con esattamente lo stesso contenuto conta come ripetizione |
In Ricorda la chiave per scegli per quanto tempo vale la chiave, in ore, giorni o settimane. Dopo questo tempo la stessa chiave fa ripartire il flusso. Con 0 la chiave vale finché non elimini l'automazione. Una chiamata senza l'intestazione scelta o senza il campo scelto viene rifiutata.
Si raggiunge una data
Questo trigger parte in una data di un record. In Data scegli qualsiasi campo data di un record che Tillor invia anche con gli eventi, scritto come record e campo. Alcuni esempi:
| Data | Record |
|---|---|
reservation.checkIn | La data di arrivo di una prenotazione |
reservation.checkOut | La data di partenza di una prenotazione |
invoice.dueDate | La scadenza di una fattura |
task.dueDate | La scadenza di un'attività |
occupation.paidUntil | Fino a quando un'occupazione è pagata |
accessMethod.periodTo | La fine della validità di un codice QR, di una targa o di un altro metodo di accesso |
nfcTag.activatedUntil | Fino a quando un tag NFC è attivato |
mandateAgreement.expiresAt | Quando scade una richiesta di firma di un mandato SEPA |
customer.birthday | La data di nascita di un cliente |
contact.birthday | La data di nascita di un contatto |
Per impostazione predefinita il trigger parte una volta, nella data stessa. Attiva Ripeti ogni anno per far contare solo giorno e mese: il flusso riparte allora ogni anno, come per il compleanno con contact.birthday. Un 29 febbraio cade il 28 febbraio negli altri anni.
Puoi scegliere anche dati salvati in un record come campi aggiuntivi. document.userMetadata.insuranceExpiryDate è la scadenza di un documento, come una prova di pagamento dell'assicurazione. Una data senza ora conta come mezzanotte (UTC, il tempo standard internazionale). Con Solo quando limiti poi il trigger a un solo tipo, per esempio document.userMetadata.documentType è INSURANCE_PAYMENT_PROOF, e ai documenti attivi con document.status è ACTIVE.
Con Quanto tempo e Prima o dopo sposti il momento. 1 giorno e Prima con reservation.checkIn fa partire il flusso un giorno prima dell'arrivo. Con 0 parte nella data stessa. Una data senza ora conta come mezzanotte.
Con Ora scegli a che ora di quel giorno parte il flusso. L'ora della data usa il momento presente nel campo, come l'ora di arrivo di una prenotazione. Ora fissa del giorno parte nel giorno della data all'ora e al minuto che scegli, nel fuso orario della tua organizzazione. Così contact.birthday con Ripeti ogni anno parte ogni anno alle 09:00 nel giorno del compleanno. Quanto tempo conta allora da quell'ora: 1 giorno e Prima parte il giorno prima alle 09:00, anche se quella notte l'orologio viene spostato.
Per ogni record parte un'esecuzione a sé, con i dati di quel record come variabili, per esempio {reservation.displayId} e {reservation.customer.firstName}. Con Solo quando la limiti, per esempio alle sole prenotazioni con stato prenotata.
Per il resto funziona così:
- Per ogni record e per ogni momento il flusso parte una volta. Se la data si sposta più avanti, per esempio perché un ospite arriva più tardi, riparte nel nuovo momento
- Se il momento era già passato quando hai salvato o attivato l'automazione, non parte più per quel momento
- I momenti persi, per esempio durante una manutenzione, Tillor li recupera fino a un'ora dopo
Ogni giorno a un'ora
In Ora scegli un'ora (da 0 a 23) e in Minuto un minuto da 0 a 59. L'orario è quello del fuso orario della tua organizzazione.
I passaggi ricevono {now}: il momento in cui è partita l'esecuzione.
In base a un'espressione cron
Scegli un ritmo, come ogni giorno, ogni lunedì alle 08:00, o i lunedì dispari (il 1°, 3° e 5°). Con Personalizzato imposti l'intervallo, i giorni della settimana e l'orario, al minuto. Con Espressione cron scrivi tu il programma.
Un'espressione cron è una notazione breve per un orario ripetuto. Ha cinque parti, separate da uno spazio: minuto, ora, giorno del mese, mese e giorno della settimana.
| Espressione | Significato |
|---|---|
0 8 * * 1 | Ogni lunedì alle 08:00 |
7 8 * * 1 | Ogni lunedì alle 08:07 |
30 7 * * 1-5 | Ogni giorno feriale alle 07:30 |
0 9 1 * * | Il primo di ogni mese alle 09:00 |
0 8 * * 1#1,1#3,1#5 | Ogni lunedì dispari (1°, 3° e 5° del mese) alle 08:00 |
0 8 * * 1L | L'ultimo lunedì del mese alle 08:00 |
0 8 * * 1 W2:2026-10-05 | Ogni due settimane di lunedì alle 08:00, a partire dalla settimana del 5 ottobre 2026 |
*/15 * * * * | Ogni quarto d'ora |
* * * * * | Ogni minuto |
In ogni parte puoi usare un numero, un elenco con virgole (8,17), un intervallo (1-5), un passo (*/15) o un asterisco (*, ogni valore). Il giorno della settimana 0 e 7 sono entrambi domenica. 1#2 è il secondo lunedì, 1L l'ultimo. Un sesto campo W2:2026-10-05 ripete ogni due settimane, contate a partire da quella settimana. Nomi come MON o JAN non funzionano. Se compili sia un giorno del mese sia un giorno della settimana, l'automazione parte in uno dei due.
Se l'espressione non è valida, Tillor lo segnala nel trigger. Gli orari valgono nel fuso orario della tua organizzazione.
A che ora parte esattamente un programma
Un programma parte nel minuto in cui tocca
Tillor controlla ogni minuto quali programmi tocca eseguire. Un'automazione che deve partire alle 08:07 parte in quel minuto. Vale per Fattura scaduta, Si raggiunge una data, Ogni giorno a un'ora e In base a un'espressione cron.
Per ogni minuto un programma parte al massimo una volta. Un controllo che gira solo nel minuto successivo non recupera il minuto precedente.
Gli eventi partono subito, senza questo ritardo.
Solo quando
Con Solo quando fai partire l'automazione solo se i dati corrispondono. Così parti, per esempio, solo per le case mobili o solo per le fatture sopra un certo importo. Lascialo vuoto per partire a ogni evento di questo tipo.
- Fai clic su Aggiungi condizione
- Scegli il campo con il pulsante Variabile (oppure digita il percorso, per esempio
invoice.status) - Scegli come confrontare
- Inserisci il valore. Per i campi con una scelta fissa, come uno stato, un tipo di terreno o un collega, scegli da un elenco
Puoi usare i seguenti confronti:
| Scelta | Corrisponde quando |
|---|---|
| è | Il campo è uguale al valore |
| non è | Il campo non è uguale al valore |
| contiene | Il valore compare da qualche parte nel campo |
| è maggiore di | Il campo è maggiore del valore (per numeri e date) |
| è minore di | Il campo è minore del valore (per numeri e date) |
| è uno tra | Il campo è uguale a uno dei valori scelti |
| è vuoto | Il campo è vuoto |
| non è vuoto | Il campo non è vuoto |
Maiuscole e minuscole non contano. I numeri vengono confrontati come numeri, quindi 10 è maggiore di 9.
Se hai più di una condizione, scegli come collaborano: Devono corrispondere tutte o Ne basta una.
Gli eventi fermati dal filtro non avviano nessuna esecuzione e quindi non lasciano traccia nella scheda Esecuzioni. Se vuoi vedere se il filtro è corretto, usa la prova: lì vedi per ogni condizione se era soddisfatta.
Esegui una volta per record
Con Esegui una volta per record l'automazione parte al massimo una volta per fattura, prenotazione o altro record, per quante volte si verifichi l'evento.
È utile soprattutto con eventi che tornano spesso, come invoice:updated: una fattura viene modificata decine di volte, ma vuoi inviare un solo promemoria. Tillor ricorda per ogni record che l'automazione è già partita. Questa memoria scompare se elimini l'automazione.
Funziona solo con eventi a cui è associato un record, e con Fattura scaduta e Si raggiunge una data. Con Si raggiunge una data significa: anche se la data si sposta più avanti, il flusso non riparte. Con un programma come Ogni giorno a un'ora non ha effetto.
Cosa succede poi?
- Ogni volta che si verifica il momento di partenza e il filtro corrisponde, parte un'esecuzione con i dati di quel momento come variabili.
- Un evento parte subito. Una data, un'ora o un programma parte nel minuto in cui tocca.
- Se il filtro non corrisponde, non parte nulla e nella scheda Esecuzioni non c'è traccia.