Declanșatoare
Alege când pornește o automatizare, inclusiv la o dată precum sosirea, filtrează cazurile și limitează-o la o singură dată per înregistrare
Ultima actualizare la
Declanșatorul este momentul de pornire al unei automatizări: „când”. Se află în partea de sus a fiecărui flux, sub numele Când se întâmplă asta. Un exemplu: pornește când se încheie o ocupare. El stabilește și ce date pot folosi pașii de după el. Un flux poate avea mai multe declanșatoare. Fiecare declanșator pornește o rulare proprie, cu filtrul lui. Adaugi unul din lista din stânga. Ultimul declanșator nu poate fi șters.
Unde pornește automatizarea
La Pornește de la alegi unul dintre cele șapte momente de pornire.
| Alegere | Pornește când |
|---|---|
| Când se întâmplă ceva | Are loc un eveniment în Tillor, de exemplu o ocupare care se încheie sau o factură care se plătește |
| Factură restantă | O factură înregistrată este încă deschisă după data scadentă |
| Webhook de intrare | Un alt sistem trimite un mesaj la adresa proprie a automatizării |
| Este aleasă o acțiune a sarcinii | Cineva alege, la o sarcină, un buton de alegere legat de această automatizare |
| Se atinge o dată | Se atinge o dată a unei înregistrări, eventual cu un timp înainte sau după. De exemplu o zi înainte de sosirea unei rezervări |
| În fiecare zi la o oră | Este ora aleasă, în fiecare zi |
| După o expresie cron | Vine rândul programului pe care îl indici |
Alegi deci mai întâi tipul de moment de pornire, apoi detaliile. Dacă alegi alt moment de pornire, filtrele de la Doar când sunt golite. Ele fuseseră scrise pentru alegerea anterioară și nu se mai potrivesc.
Când se întâmplă ceva
La Eveniment alegi ce trebuie să pornească automatizarea. Dă clic pe câmp și scrie pentru a căuta, de exemplu occupation sau invoice. Evenimentele apar în notația Tillor, ca occupation:ended: mai întâi despre ce este vorba, apoi ce s-a întâmplat.
Acestea sunt evenimentele de care ai nevoie cel mai des:
| Eveniment | Pornește când |
|---|---|
occupation:ended | Se încheie o ocupare |
reservation:created | Se creează o rezervare |
reservation:updated | O rezervare este modificată |
customer:created | Se creează un client |
customer:updated | Un client este modificat |
invoice:created | Se creează o factură |
invoice:updated | O factură este modificată |
invoice:paid | O factură este plătită |
payment:created | Intră o plată |
task:created | Se creează o sarcină |
task:status-changed | Se schimbă starea unei sarcini |
task:assigned | O sarcină este atribuită cuiva |
task:action-chosen | Cineva alege un buton de alegere la o sarcină |
integration-alarm:created | Un contor dă o alarmă |
comment:created | Se postează un comentariu |
document:created | Se adaugă un document |
signatureRequest:updated | O cerere de semnare este actualizată |
signatureRequest:completed | Toți semnatarii unei cereri de semnare au semnat |
mandate-agreement:signed | Un client a semnat un mandat SEPA |
mandate-agreement:activated | Un mandat SEPA a devenit activ |
mandate-agreement:expired | O cerere de mandat SEPA a expirat fără semnătură |
mandate-agreement:failed | Activarea unui mandat SEPA a fost refuzată sau a eșuat |
productPriceChange:applied | Intră în vigoare un preț de produs programat |
Este aceeași listă ca cea a webhook-urilor. Poți deci folosi orice eveniment pentru care Tillor poate trimite un webhook. Câteva evenimente extrem de frecvente, precum starea fizică a barierelor, scrisul în inbox, jurnalele controllerelor și prezența vehiculelor, nu apar în listă.
Îți lipsește un eveniment?
Sub câmpul Eveniment se află linkul Lipsește un eveniment? Solicită-l. Vezi Solicitarea unui pas sau a unui eveniment.
Ce date primești
La majoritatea evenimentelor există o înregistrare, de exemplu o ocupare, o factură sau o sarcină. Această înregistrare, plus înregistrările la care face referire, sunt apoi disponibile ca variabile în pași. La occupation:ended poți folosi, de exemplu:
{occupation.terrain.name}pentru numele terenului{occupation.customer.firstName}pentru prenumele clientului{occupation.reservation.displayId}pentru numărul rezervării. Nu orice ocupare are o rezervare: atunci rămâne gol
În plus există mereu {triggeredBy.name} și {triggeredBy.id}: colegul care a provocat evenimentul. Dacă evenimentul a fost provocat de sistem, de exemplu de o sincronizare bancară, aceste câmpuri sunt goale.
Sub setările declanșatorului se află Datele pe care le oferă acest eveniment. Acolo vezi exact ce variabile poți folosi. La un eveniment ale cărui date nu sunt descrise, Tillor spune că nu e nimic de ales. Variabilele pe care le scrii tu funcționează în continuare. Vezi Variabile și șabloane.
Este aleasă o acțiune a sarcinii
Unele sarcini au butoane de alegere în loc de bifă, de exemplu din Cere o decizie. Un buton poate fi legat de o automatizare. Cu acest declanșator, automatizarea pornește imediat ce cineva alege acel buton. Vezi și Sarcini cu butoane de alegere.
Legarea unui buton de o automatizare nu se face în editorul de fluxuri. Dacă ai nevoie de asta, cere-i administratorului Tillor sau suportului.
Pașii primesc datele sarcinii, de exemplu {task.name} și {task.id}, plus {action.label} (numele butonului ales) și {note} (nota completată de coleg, dacă butonul a cerut-o). Sub Datele pe care le oferă acest eveniment vezi lista completă.
Factură restantă
Acest declanșator pornește pentru fiecare factură care:
- este înregistrată (ciornele și facturile anulate nu se iau în calcul)
- nu este notă de credit
- mai are o sumă deschisă
- are o dată scadentă dinainte de azi
Pentru fiecare astfel de factură pornește o rulare proprie. Datele facturii și ale clientului sunt disponibile ca {invoice.…}, de exemplu {invoice.displayId}, {invoice.amountOutstanding} și {invoice.customer.firstName}.
Dacă dezactivezi Rulează o singură dată per înregistrare, automatizarea pornește pentru aceeași factură cel mult o dată pe zi cât timp aceasta este restantă. Dacă îl lași activat, pornește exact o dată pentru fiecare factură. De obicei asta este ce vrei pentru un memento.
La De reamintit alegi cât timp trebuie să fie deschisă factura, aceeași regulă ca în lista de facturi. Activează Omite clienții excluși de la somații automate pentru a sări peste clienții care au setat asta în setările lor de facturare. O factură scoasă ea însăși din reamintirile automate nu pornește nici ea fluxul.
Webhook de intrare
Un webhook este un mesaj pe care un alt sistem îl trimite la o adresă. Cu acest declanșator, acel sistem pornește automatizarea, de exemplu site-ul tău, un formular sau o platformă de rezervări. Fiecare automatizare primește o adresă proprie, secretă.
- La Pornește de la alege Webhook de intrare
- Salvează automatizarea. La Adresă apare URL-ul
- Dă clic pe Copiază și setează adresa în celălalt sistem
- Activează automatizarea
Celălalt sistem trimite un POST cu JSON la acea adresă. Conținutul este apoi disponibil ca {body.…}, de exemplu {body.email} sau {body.reservering.nummer}, iar parametrii din URL ca {query.…}. Cu Doar când poți filtra și după aceste câmpuri.
Mai departe, funcționează așa:
- Adresa este secretul. Cine o cunoaște poate porni automatizarea. Împarte-o deci doar cu sistemul care are nevoie de ea
- Dacă adresa a ajuns pe mâini greșite, dă clic pe Adresă nouă și salvează. Adresa veche nu mai funcționează din acel moment
- O automatizare dezactivată sau o adresă greșită dă eroarea
404 - Conținutul poate avea cel mult 100 KB
- Fiecare apel pornește o rulare pentru fiecare declanșator webhook din flux. Adresa aparține primului declanșator webhook. Adresă nouă la acel declanșator o înlocuiește
- Nu este legată nicio înregistrare, deci Rulează o singură dată per înregistrare nu are efect
Ignoră repetările
Dacă celălalt sistem trimite uneori același apel de două ori, cu Ignoră repetările eviți ca fluxul să pornească de două ori. Tillor ține minte o cheie a apelului. Dacă aceeași cheie vine din nou, nu pornește nimic.
| Alegere | Ce este cheia |
|---|---|
| Fiecare apel pornește fluxul | Nu există cheie. Implicit |
| Dintr-un antet | Valoarea unui antet pe care îl alegi la Numele antetului, de exemplu Idempotency-Key |
| Din corpul JSON | Valoarea unui câmp din JSON, pe care îl alegi la Câmp, precum id sau data.eventId |
| Același corp JSON | Întregul conținut. Un apel cu exact același conținut se socotește repetare |
La Ține minte cheia timp de alegi cât timp este valabilă cheia, în ore, zile sau săptămâni. După acest timp, aceeași cheie pornește din nou fluxul. La 0, cheia este valabilă până ștergi automatizarea. Un apel fără antetul ales sau fără câmpul ales este refuzat.
Se atinge o dată
Acest declanșator pornește la o dată a unei înregistrări. La Dată alegi orice câmp de dată al unei înregistrări pe care Tillor o trimite și la evenimente, scris ca înregistrare și câmp. Câteva exemple:
| Dată | Înregistrare |
|---|---|
reservation.checkIn | Data sosirii unei rezervări |
reservation.checkOut | Data plecării unei rezervări |
invoice.dueDate | Data scadentă a unei facturi |
task.dueDate | Termenul limită al unei sarcini |
occupation.paidUntil | Până când este plătită o ocupare |
accessMethod.periodTo | Sfârșitul valabilității unui cod QR, a unui număr de înmatriculare sau a altei metode de acces |
nfcTag.activatedUntil | Până când este activat un tag NFC |
mandateAgreement.expiresAt | Când expiră o cerere de semnare a unui mandat SEPA |
customer.birthday | Data nașterii unui client |
contact.birthday | Data nașterii unei persoane de contact |
Implicit, declanșatorul pornește o singură dată, chiar la acea dată. Activează Repetă în fiecare an pentru ca să conteze doar ziua și luna: atunci fluxul pornește din nou în fiecare an, ca la ziua de naștere de la contact.birthday. Un 29 februarie cade în alți ani pe 28 februarie.
Poți alege și datele salvate la o înregistrare ca câmpuri suplimentare. document.userMetadata.insuranceExpiryDate este data scadentă a unui document, precum dovada plății asigurării. O astfel de dată fără oră se socotește ca miezul nopții (UTC, ora standard internațională). Cu Doar când limitezi apoi declanșatorul la un tip, de exemplu document.userMetadata.documentType este INSURANCE_PAYMENT_PROOF, și la documentele active cu document.status este ACTIVE.
Cu Cât timp și Înainte sau după muți momentul. 1 zi și Înainte la reservation.checkIn pornește fluxul cu o zi înainte de sosire. La 0 pornește chiar la dată. O dată fără oră se socotește ca miezul nopții.
Cu Ora alegi când, în acea zi, pornește fluxul. Ora din dată folosește momentul din câmp, precum ora sosirii unei rezervări. Oră fixă din zi pornește în ziua datei la ora și minutul pe care le alegi, în fusul orar al organizației tale. Astfel contact.birthday cu Repetă în fiecare an pornește în fiecare an la 09:00, de ziua de naștere. Cât timp se numără atunci de la acea oră: 1 zi și Înainte pornește cu o zi înainte la 09:00, chiar dacă în acea noapte se schimbă ora.
Pentru fiecare înregistrare pornește o rulare proprie, cu datele acelei înregistrări ca variabile, de exemplu {reservation.displayId} și {reservation.customer.firstName}. Cu Doar când îl limitezi, de exemplu doar rezervările cu starea înregistrată.
Mai departe, funcționează așa:
- Pentru fiecare înregistrare și fiecare moment, fluxul pornește o singură dată. Dacă data se mută mai târziu, de exemplu pentru că un oaspete sosește mai târziu, fluxul pornește din nou la noul moment
- Dacă momentul era deja trecut când ai salvat sau activat automatizarea, nu mai pornește pentru el
- Momentele ratate, de exemplu în timpul unei mentenanțe, sunt recuperate de Tillor până la o oră mai târziu
În fiecare zi la o oră
La Oră alegi o oră (de la 0 la 23) și la Minut un minut de la 0 la 59. Ora este ora din fusul orar al organizației tale.
Pașii primesc {now}: momentul în care a pornit rularea.
După o expresie cron
Alege un ritm, precum în fiecare zi, în fiecare luni la 08:00 sau în lunile impare (a 1-a, a 3-a și a 5-a). La Personalizat setezi intervalul, zilele săptămânii și ora, până la minut. La Expresie cron scrii tu programul.
O expresie cron este o scriere scurtă pentru o oră care se repetă. Are cinci părți, separate printr-un spațiu: minut, oră, ziua lunii, luna și ziua săptămânii.
| Expresie | Semnificație |
|---|---|
0 8 * * 1 | În fiecare luni la 08:00 |
7 8 * * 1 | În fiecare luni la 08:07 |
30 7 * * 1-5 | În fiecare zi lucrătoare la 07:30 |
0 9 1 * * | În prima zi a fiecărei luni la 09:00 |
0 8 * * 1#1,1#3,1#5 | În fiecare luni impară (a 1-a, a 3-a și a 5-a din lună) la 08:00 |
0 8 * * 1L | Ultima luni din lună la 08:00 |
0 8 * * 1 W2:2026-10-05 | La fiecare două săptămâni, lunea la 08:00, începând cu săptămâna de 5 octombrie 2026 |
*/15 * * * * | În fiecare sfert de oră |
* * * * * | În fiecare minut |
În fiecare parte poți folosi un număr, o listă cu virgule (8,17), un interval (1-5), un pas (*/15) sau o stea (*, orice valoare). Ziua săptămânii 0 și 7 sunt amândouă duminică. 1#2 este a doua luni, 1L ultima. Un al șaselea câmp W2:2026-10-05 se repetă la fiecare două săptămâni, numărate de la acea săptămână. Nume precum MON sau JAN nu funcționează. Dacă completezi atât o zi a lunii, cât și o zi a săptămânii, automatizarea pornește la una dintre ele.
Dacă expresia nu este validă, Tillor anunță asta la declanșator. Orele sunt în fusul orar al organizației tale.
La ce oră pornește exact un program
Un program pornește în minutul în care îi vine rândul
Tillor verifică în fiecare minut ce programe sunt la rând. O automatizare care trebuie să pornească la 08:07 pornește în acel minut. Asta se aplică la Factură restantă, Se atinge o dată, În fiecare zi la o oră și După o expresie cron.
Pe minut, un program pornește cel mult o dată. O verificare care rulează abia în minutul următor nu mai recuperează minutul anterior.
Evenimentele pornesc imediat, fără această întârziere.
Doar când
Cu Doar când pornești automatizarea numai dacă datele se potrivesc. Astfel pornești, de exemplu, doar pentru rulote fixe sau doar pentru facturi peste o sumă. Lasă gol pentru a porni la fiecare eveniment de acest tip.
- Dă clic pe Adaugă condiție
- Alege câmpul cu butonul Variabilă (sau scrie calea, de exemplu
invoice.status) - Alege cum compari
- Completează valoarea. La câmpurile cu alegere fixă, precum o stare, un tip de teren sau un coleg, alegi dintr-o listă
Poți folosi următoarele comparații:
| Alegere | Se potrivește când |
|---|---|
| este | Câmpul este egal cu valoarea |
| nu este | Câmpul nu este egal cu valoarea |
| conține | Valoarea apare undeva în câmp |
| este mai mare decât | Câmpul este mai mare decât valoarea (la numere și date) |
| este mai mic decât | Câmpul este mai mic decât valoarea (la numere și date) |
| este unul dintre | Câmpul este egal cu una dintre valorile alese |
| este gol | Câmpul este gol |
| nu este gol | Câmpul nu este gol |
Majusculele nu contează. Numerele se compară ca numere, deci 10 este mai mare decât 9.
Dacă ai mai mult de o condiție, alegi cum lucrează împreună: Toate trebuie să se potrivească sau Este suficientă una.
Evenimentele oprite de filtru nu pornesc nicio rulare și nu lasă deci nicio urmă în fila Rulări. Dacă vrei să vezi dacă filtrul tău este corect, folosește testarea: acolo vezi, pentru fiecare condiție, dacă s-a potrivit.
Rulează o singură dată per înregistrare
Cu Rulează o singură dată per înregistrare, automatizarea pornește cel mult o dată per factură, rezervare sau altă înregistrare, oricât de des se produce evenimentul pentru ea.
Este util mai ales la evenimente care revin des, precum invoice:updated: o factură este modificată de zeci de ori, dar tu vrei să trimiți un singur memento. Tillor ține minte, pentru fiecare înregistrare, că automatizarea a pornit deja. Această memorie dispare dacă ștergi automatizarea.
Funcționează doar la evenimentele care au o înregistrare, la Factură restantă și la Se atinge o dată. La Se atinge o dată înseamnă: chiar dacă data se mută mai târziu, fluxul nu pornește din nou. La un program precum În fiecare zi la o oră nu are efect.
Ce se întâmplă apoi?
- De fiecare dată când apare momentul de pornire și filtrul se potrivește, pornește o rulare cu datele acelui moment ca variabile.
- Un eveniment pornește imediat. O dată, o oră sau un program pornește în minutul în care îi vine rândul.
- Dacă filtrul nu se potrivește, nu pornește nimic și nu rămâne nicio urmă în fila Rulări.