Triggers

De trigger staat bovenaan elke flow, onder de naam Wanneer dit gebeurt. Hij bepaalt wanneer de automatisering start en welke gegevens de stappen daarna kunnen gebruiken. Een flow kan meerdere triggers hebben. Elke trigger start een eigen uitvoering, met zijn eigen filter. Je voegt er een toe vanuit de lijst links. De laatste trigger kun je niet verwijderen.

Waar start de automatisering opLink naar deze sectie kopiëren

Bij Start bij kies je een van zes startmomenten.

Kies je een ander startmoment, dan worden de filters bij Alleen wanneer leeggemaakt. Die waren geschreven voor de vorige keuze en passen niet meer.

Als er iets gebeurtLink naar deze sectie kopiëren

Kies bij Gebeurtenis wat de automatisering moet starten. Klik op het veld en typ om te zoeken, bijvoorbeeld occupation of invoice. De gebeurtenissen staan in de notatie van Tillor, zoals occupation:ended: eerst waar het over gaat, dan wat er gebeurde.

Dit zijn de gebeurtenissen die je het vaakst nodig hebt:

Dit is dezelfde lijst als die van de webhooks. Je kunt dus elke gebeurtenis gebruiken waarvoor Tillor een webhook kan sturen. Een paar gebeurtenissen die extreem vaak voorkomen, zoals de fysieke toestand van barrières of het typen in de inbox, staan niet in de lijst.

Welke gegevens krijg je meeLink naar deze sectie kopiëren

Bij de meeste gebeurtenissen hoort een record, zoals een bezetting, een factuur of een taak. Dat record, plus de records waar het naar verwijst, zijn daarna als variabelen beschikbaar in de stappen. Bij occupation:ended kun je bijvoorbeeld gebruiken:

• {occupation.terrain.name} voor de naam van het terrein
• {occupation.customer.firstName} voor de voornaam van de klant
• {occupation.reservation.displayId} voor het nummer van de reservering. Niet elke bezetting heeft een reservering: dan blijft dit leeg

Daarnaast zijn er altijd {triggeredBy.name} en {triggeredBy.id}: de collega die de gebeurtenis veroorzaakte. Is de gebeurtenis door het systeem veroorzaakt, bijvoorbeeld door een bank-synchronisatie, dan zijn die velden leeg.

Onder de instellingen van de trigger staat Gegevens die deze gebeurtenis levert. Daar zie je precies welke variabelen je kunt gebruiken. Bij een gebeurtenis waarvan de gegevens niet beschreven zijn, zegt Tillor dat er niets te kiezen valt. Variabelen die je zelf typt, werken dan nog steeds. Zie Variabelen en sjablonen.

Factuur is vervallenLink naar deze sectie kopiëren

Deze trigger start voor elke factuur die:

• geboekt is (concepten en geannuleerde facturen tellen niet mee)
• geen creditnota is
• nog een openstaand bedrag heeft
• een vervaldatum vóór vandaag heeft

Voor elke zo'n factuur start een eigen uitvoering. De gegevens van de factuur en de klant zijn beschikbaar als {invoice.…}, bijvoorbeeld {invoice.displayId}, {invoice.amountOutstanding} en {invoice.customer.firstName}.

Zet je Eén keer per record uitvoeren uit, dan start de automatisering voor dezelfde factuur hoogstens één keer per dag zolang ze vervallen is. Laat je het aan, dan start hij voor elke factuur precies één keer. Dat is meestal wat je wilt voor een herinnering.

Bij Aan herinnering toe kies je hoe lang de factuur al open moet staan, dezelfde regel als in de facturenlijst. Zet Klanten uitsluiten die geen automatische aanmaningen krijgen aan om klanten over te slaan die dat in hun facturatie-instellingen hebben staan. Een factuur die zelf uit automatische herinneringen is gehaald, start de flow ook niet.

Inkomende webhookLink naar deze sectie kopiëren

Met deze trigger start een ander systeem de automatisering, bijvoorbeeld je website, een formulier of een boekingsplatform. Elke automatisering krijgt een eigen, geheim adres.

1. Kies bij Start bij Inkomende webhook
2. Sla de automatisering op. Bij Adres verschijnt de URL
3. Klik op Kopiëren en stel het adres in bij het andere systeem
4. Schakel de automatisering in

Het andere systeem stuurt een POST met JSON naar dat adres. De inhoud is daarna beschikbaar als {body.…}, bijvoorbeeld {body.email} of {body.reservering.nummer}, en parameters in de URL als {query.…}. Met Alleen wanneer kun je ook op die velden filteren.

Zo werkt het verder:

• Het adres is het geheim. Wie het kent, kan de automatisering starten. Deel het dus alleen met het systeem dat het nodig heeft
• Lekt het adres uit, klik dan op Nieuw adres en sla op. Het oude adres werkt vanaf dan niet meer
• Een uitgeschakelde automatisering of een verkeerd adres geeft een fout 404
• De inhoud mag hoogstens 100 KB zijn
• Elke aanroep start één uitvoering per webhook-trigger in de flow. Het adres hoort bij de eerste webhook-trigger. Nieuw adres op die trigger vervangt het
• Er is geen record aan gekoppeld, dus Eén keer per record uitvoeren heeft geen effect

Een datum is bereiktLink naar deze sectie kopiëren

Deze trigger start op een datum van een record. Bij Datum kies je elk datumveld van een record dat Tillor ook bij gebeurtenissen meestuurt, geschreven als record en veld. Enkele voorbeelden:

Standaard start de trigger één keer, op de datum zelf. Zet Elk jaar herhalen aan om alleen dag en maand te laten tellen: dan start de flow elk jaar opnieuw, zoals op de verjaardag bij contact.birthday. Een 29 februari valt in andere jaren op 28 februari.

Ook gegevens die bij een record als extra velden zijn opgeslagen, kun je kiezen. document.userMetadata.insuranceExpiryDate is de vervaldatum van een document, zoals een betalingsbewijs van de verzekering. Zo'n datum zonder uur telt als middernacht UTC. Met Alleen wanneer beperk je de trigger dan tot één type, bijvoorbeeld document.userMetadata.documentType is INSURANCE_PAYMENT_PROOF, en tot actieve documenten met document.status is ACTIVE.

Met Hoelang en Ervoor of erna verschuif je het moment. 1 dag en Ervoor bij reservation.checkIn start de flow een dag voor de aankomst. Bij 0 start hij op de datum zelf. Een datum zonder uur telt als middernacht.

Met Tijdstip kies je wanneer op die dag de flow start. Het uur in de datum gebruikt het moment dat in het veld staat, zoals het aankomstuur van een reservering. Vast uur van de dag start op de dag van de datum op het uur en de minuut die je kiest, in de tijdzone van je organisatie. Zo start contact.birthday met Elk jaar herhalen elk jaar om 09:00 op de verjaardag. Hoelang telt dan vanaf dat uur: 1 dag en Ervoor start de dag ervoor om 09:00, ook als de klok die nacht verzet wordt.

Voor elk record start een eigen uitvoering, met de gegevens van dat record als variabelen, bijvoorbeeld {reservation.displayId} en {reservation.customer.firstName}. Met Alleen wanneer beperk je het, zoals alleen reserveringen met status geboekt.

Zo werkt het verder:

• Per record en per moment start de flow één keer. Verschuift de datum naar later, bijvoorbeeld omdat een gast later aankomt, dan start hij op het nieuwe moment opnieuw
• Lag het moment al voorbij toen je de automatisering opsloeg of inschakelde, dan start hij er niet meer voor
• Gemiste momenten, bijvoorbeeld tijdens een onderhoud, haalt Tillor tot een uur later nog in

Elke dag op een uurLink naar deze sectie kopiëren

Kies bij Uur een uur (0 tot en met 23) en bij Minuut een minuut van 0 tot en met 59. De tijd is de tijd in de tijdzone van je organisatie.

De stappen krijgen {now} mee: het moment waarop de uitvoering startte.

Volgens een cron-expressieLink naar deze sectie kopiëren

Kies een ritme, zoals elke dag, elke maandag om 08:00, of de oneven maandagen (de 1e, 3e en 5e). Bij Aangepast stel je het interval, de weekdagen en het tijdstip in, tot op de minuut. Bij Cron-expressie schrijf je het schema zelf.

Een cron-expressie heeft vijf delen, gescheiden door een spatie: minuut, uur, dag van de maand, maand en weekdag.

In elk deel kun je een getal, een lijst met komma's (8,17), een bereik (1-5), een stap (*/15) of een ster (*, elke waarde) gebruiken. Weekdag 0 en 7 zijn allebei zondag. 1#2 is de tweede maandag, 1L de laatste. Een zesde veld W2:2026-10-05 herhaalt om de twee weken, geteld vanaf die week. Namen zoals MON of JAN werken niet. Vul je zowel een dag van de maand als een weekdag in, dan start de automatisering op een van beide.

Is de expressie ongeldig, dan meldt Tillor dat bij de trigger. De tijden gelden in de tijdzone van je organisatie.

Hoe laat start een schema preciesLink naar deze sectie kopiëren

Per minuut start een schema hoogstens één keer. Een controle die in de volgende minuut pas loopt, haalt de vorige minuut niet meer in.

Gebeurtenissen starten direct, zonder deze vertraging.

Alleen wanneerLink naar deze sectie kopiëren

Met Alleen wanneer laat je de automatisering alleen starten als de gegevens kloppen. Zo start je bijvoorbeeld alleen voor stacaravans, of alleen voor facturen boven een bedrag. Laat het leeg om bij elke gebeurtenis van dit type te starten.

1. Klik op Voorwaarde toevoegen
2. Kies het veld met de knop Variabele (of typ het pad, bijvoorbeeld invoice.status)
3. Kies hoe je vergelijkt
4. Vul de waarde in. Bij velden met een vaste keuze, zoals een status, een terreintype of een medewerker, kies je uit een lijst

Je kunt de volgende vergelijkingen gebruiken:

Hoofdletters maken niet uit. Getallen worden als getal vergeleken, dus 10 is groter dan 9.

Heb je meer dan één voorwaarde, dan kies je hoe ze samenwerken: Alle moeten kloppen of Minstens één moet kloppen.

Eén keer per record uitvoerenLink naar deze sectie kopiëren

Met Eén keer per record uitvoeren start de automatisering hoogstens één keer per factuur, reservering of ander record, hoe vaak de gebeurtenis er ook voor optreedt.

Dat is vooral handig bij gebeurtenissen die vaak terugkomen, zoals invoice:updated: een factuur wordt tientallen keren gewijzigd, maar je wilt maar één herinnering sturen. Tillor onthoudt per record dat de automatisering al gestart is. Dat onthouden verdwijnt als je de automatisering verwijdert.

Het werkt alleen bij gebeurtenissen waar een record bij hoort, en bij Factuur is vervallen en Een datum is bereikt. Bij Een datum is bereikt betekent het: ook als de datum later verschuift, start de flow niet opnieuw. Bij een schema als Elke dag op een uur heeft het geen effect.

Meer lezenLink naar deze sectie kopiëren