Wyzwalacze

Wyzwalacz to moment startu automatyzacji: to "kiedy". Stoi na samej górze każdego przepływu, pod nazwą Gdy to się wydarzy. Przykład: uruchom, gdy zakończy się zajęcie. Określa też, z jakich danych mogą korzystać kolejne kroki. Przepływ może mieć kilka wyzwalaczy. Każdy wyzwalacz uruchamia własne wykonanie, z własnym filtrem. Dodajesz go z listy po lewej. Ostatniego wyzwalacza nie możesz usunąć.

Od czego startuje automatyzacjaKopiuj link do tej sekcji

W polu Startuje od wybierasz jeden z siedmiu momentów startu.

Wybierasz więc najpierw rodzaj momentu startu, a potem szczegóły. Jeśli wybierzesz inny moment startu, filtry w Tylko gdy zostaną wyczyszczone. Były napisane pod poprzedni wybór i już nie pasują.

Gdy coś się wydarzyKopiuj link do tej sekcji

W polu Zdarzenie wybierz, co ma uruchomić automatyzację. Kliknij pole i wpisz, aby wyszukać, na przykład occupation albo invoice. Zdarzenia są zapisane w notacji Tillor, jak occupation:ended: najpierw czego dotyczy, potem co się stało.

Oto zdarzenia, których potrzebujesz najczęściej:

To ta sama lista co w webhookach. Możesz więc użyć każdego zdarzenia, dla którego Tillor może wysłać webhook. Kilka zdarzeń występujących wyjątkowo często, takich jak fizyczny stan szlabanów, pisanie w skrzynce, logi kontrolerów i obecność pojazdów, nie ma na liście.

Jakie dane dostajeszKopiuj link do tej sekcji

Do większości zdarzeń należy rekord, taki jak zajęcie, faktura czy zadanie. Ten rekord oraz rekordy, do których się odwołuje, są potem dostępne jako zmienne w krokach. Przy occupation:ended możesz na przykład użyć:

• {occupation.terrain.name} dla nazwy terenu
• {occupation.customer.firstName} dla imienia klienta
• {occupation.reservation.displayId} dla numeru rezerwacji. Nie każde zajęcie ma rezerwację: wtedy to pole pozostaje puste

Poza tym zawsze są {triggeredBy.name} i {triggeredBy.id}: kolega, który wywołał zdarzenie. Jeśli zdarzenie wywołał system, na przykład synchronizacja bankowa, te pola są puste.

Pod ustawieniami wyzwalacza jest Dane, które dostarcza to zdarzenie. Tam widzisz dokładnie, jakich zmiennych możesz użyć. Przy zdarzeniu, którego dane nie są opisane, Tillor mówi, że nie ma czego wybierać. Zmienne, które wpiszesz samodzielnie, nadal działają. Zobacz Zmienne i szablony.

Wybrano akcję zadaniaKopiuj link do tej sekcji

Niektóre zadania mają przyciski wyboru zamiast haczyka, na przykład z kroku Poproś o decyzję. Przycisk może być powiązany z automatyzacją. Z tym wyzwalaczem ta automatyzacja uruchamia się, gdy tylko ktoś wybierze ten przycisk. Zobacz też Zadania z przyciskami wyboru.

Powiązania przycisku z automatyzacją nie robisz w edytorze przepływu. Jeśli tego potrzebujesz, poproś o to administratora Tillor albo support.

Kroki dostają dane zadania, na przykład {task.name} i {task.id}, a do tego {action.label} (nazwa wybranego przycisku) i {note} (notatka wpisana przez kolegę, jeśli przycisk o nią prosił). Pod Dane, które dostarcza to zdarzenie zobaczysz pełną listę.

Faktura przeterminowanaKopiuj link do tej sekcji

Ten wyzwalacz uruchamia się dla każdej faktury, która:

• jest zaksięgowana (szkice i anulowane faktury się nie liczą)
• nie jest notą kredytową
• ma jeszcze kwotę do zapłaty
• ma termin płatności przed dzisiejszym dniem

Dla każdej takiej faktury uruchamia się osobne wykonanie. Dane faktury i klienta są dostępne jako {invoice.…}, na przykład {invoice.displayId}, {invoice.amountOutstanding} i {invoice.customer.firstName}.

Jeśli wyłączysz Uruchom raz na rekord, automatyzacja uruchomi się dla tej samej faktury najwyżej raz dziennie, dopóki jest przeterminowana. Jeśli zostawisz to włączone, uruchomi się dla każdej faktury dokładnie raz. To zwykle jest to, czego chcesz przy przypomnieniu.

W polu Do przypomnienia wybierasz, jak długo faktura ma już być otwarta, według tej samej reguły co na liście faktur. Włącz Pomiń klientów wyłączonych z automatycznych przypomnień, aby pominąć klientów, którzy mają to ustawione w swoich ustawieniach fakturowania. Faktura, która sama została wyłączona z automatycznych przypomnień, również nie uruchamia przepływu.

Webhook przychodzącyKopiuj link do tej sekcji

Webhook to wiadomość, którą inny system wysyła na jakiś adres. Z tym wyzwalaczem ten system uruchamia automatyzację, na przykład Twoja strona, formularz albo platforma rezerwacyjna. Każda automatyzacja dostaje własny, tajny adres.

1. W polu Startuje od wybierz Webhook przychodzący
2. Zapisz automatyzację. W polu Adres pojawi się URL
3. Kliknij Kopiuj i ustaw ten adres w drugim systemie
4. Włącz automatyzację

Drugi system wysyła POST z JSON na ten adres. Treść jest potem dostępna jako {body.…}, na przykład {body.email} albo {body.reservering.nummer}, a parametry w adresie URL jako {query.…}. Za pomocą Tylko gdy możesz filtrować także po tych polach.

Dalej działa to tak:

• Tajemnicą jest adres. Kto go zna, może uruchomić automatyzację. Udostępnij go więc tylko systemowi, który go potrzebuje
• Jeśli adres wycieknie, kliknij Nowy adres i zapisz. Stary adres od tej chwili nie działa
• Wyłączona automatyzacja albo błędny adres daje błąd 404
• Treść może mieć najwyżej 100 KB
• Każde wywołanie uruchamia jedno wykonanie na każdy wyzwalacz webhooka w przepływie. Adres należy do pierwszego wyzwalacza webhooka. Nowy adres na tym wyzwalaczu go zastępuje
• Nie jest z tym powiązany żaden rekord, więc Uruchom raz na rekord nie ma efektu

Ignorowanie powtórzeńKopiuj link do tej sekcji

Jeśli drugi system czasem wysyła to samo wywołanie dwa razy, za pomocą Ignoruj powtórzenia zapobiegasz dwukrotnemu uruchomieniu przepływu. Tillor zapamiętuje klucz wywołania. Jeśli ten sam klucz przyjdzie ponownie, nic się nie uruchamia.

W polu Pamiętaj klucz przez wybierasz, jak długo klucz obowiązuje, w godzinach, dniach lub tygodniach. Po tym czasie ten sam klucz uruchamia przepływ ponownie. Przy 0 klucz obowiązuje, dopóki nie usuniesz automatyzacji. Wywołanie bez wybranego nagłówka albo bez wybranego pola jest odrzucane.

Nadeszła dataKopiuj link do tej sekcji

Ten wyzwalacz uruchamia się w dniu będącym datą rekordu. W polu Data wybierasz dowolne pole daty rekordu, które Tillor wysyła też przy zdarzeniach, zapisane jako rekord i pole. Kilka przykładów:

Domyślnie wyzwalacz uruchamia się jeden raz, w samym dniu daty. Włącz Powtarzaj co roku, aby liczyły się tylko dzień i miesiąc: wtedy przepływ uruchamia się co roku od nowa, na przykład w urodziny przy contact.birthday. 29 lutego w innych latach przypada na 28 lutego.

Możesz też wybrać dane zapisane przy rekordzie jako dodatkowe pola. document.userMetadata.insuranceExpiryDate to termin ważności dokumentu, takiego jak dowód opłacenia ubezpieczenia. Taka data bez godziny liczy się jako północ (UTC, międzynarodowy czas standardowy). Za pomocą Tylko gdy ograniczasz wtedy wyzwalacz do jednego typu, na przykład document.userMetadata.documentType jest INSURANCE_PAYMENT_PROOF, oraz do aktywnych dokumentów z document.status jest ACTIVE.

Za pomocą Jak długo i Przed czy po przesuwasz moment. 1 dzień i Przed przy reservation.checkIn uruchamia przepływ dzień przed przyjazdem. Przy 0 uruchamia się w samym dniu daty. Data bez godziny liczy się jako północ.

Za pomocą Czas wybierasz, o której tego dnia przepływ się uruchamia. Godzina z daty używa momentu zapisanego w polu, takiego jak godzina przyjazdu rezerwacji. Stała godzina dnia uruchamia się w dniu daty o wybranej godzinie i minucie, w strefie czasowej Twojej organizacji. Tak contact.birthday z Powtarzaj co roku uruchamia się co roku o 09:00 w urodziny. Jak długo liczy się wtedy od tej godziny: 1 dzień i Przed uruchamia się dzień wcześniej o 09:00, nawet jeśli tej nocy zmieni się czas.

Dla każdego rekordu uruchamia się osobne wykonanie, z danymi tego rekordu jako zmiennymi, na przykład {reservation.displayId} i {reservation.customer.firstName}. Za pomocą Tylko gdy to ograniczasz, na przykład tylko do rezerwacji ze statusem zarezerwowana.

Dalej działa to tak:

• Dla każdego rekordu i każdego momentu przepływ uruchamia się jeden raz. Jeśli data przesunie się na później, na przykład bo gość przyjedzie później, uruchomi się ponownie w nowym momencie
• Jeśli moment minął już w chwili, gdy zapisywałeś lub włączałeś automatyzację, nie uruchomi się już dla niego
• Pominięte momenty, na przykład podczas prac konserwacyjnych, Tillor nadrabia do godziny później

Codziennie o danej godzinieKopiuj link do tej sekcji

W polu Godzina wybierz godzinę (od 0 do 23), a w polu Minuta minutę od 0 do 59. Czas jest czasem w strefie czasowej Twojej organizacji.

Kroki dostają {now}: moment, w którym wykonanie się uruchomiło.

Według wyrażenia cronKopiuj link do tej sekcji

Wybierz rytm, taki jak codziennie, w każdy poniedziałek o 08:00 albo nieparzyste poniedziałki (1., 3. i 5.). W Niestandardowy ustawiasz odstęp, dni tygodnia i godzinę, co do minuty. W Wyrażenie cron harmonogram piszesz sam.

Wyrażenie cron to krótki zapis powtarzającego się czasu. Ma pięć części oddzielonych spacją: minuta, godzina, dzień miesiąca, miesiąc i dzień tygodnia.

W każdej części możesz użyć liczby, listy z przecinkami (8,17), zakresu (1-5), kroku (*/15) albo gwiazdki (*, każda wartość). Dzień tygodnia 0 i 7 to obydwa niedziela. 1#2 to drugi poniedziałek, 1L ostatni. Szóste pole W2:2026-10-05 powtarza co dwa tygodnie, licząc od tego tygodnia. Nazwy takie jak MON czy JAN nie działają. Jeśli wypełnisz zarówno dzień miesiąca, jak i dzień tygodnia, automatyzacja uruchomi się przy jednym z nich.

Jeśli wyrażenie jest nieprawidłowe, Tillor zgłasza to przy wyzwalaczu. Czasy obowiązują w strefie czasowej Twojej organizacji.

O której dokładnie uruchamia się harmonogramKopiuj link do tej sekcji

Na minutę harmonogram uruchamia się najwyżej raz. Kontrola, która działa dopiero w następnej minucie, nie nadrabia poprzedniej minuty.

Zdarzenia uruchamiają się od razu, bez tego opóźnienia.

Tylko gdyKopiuj link do tej sekcji

Za pomocą Tylko gdy sprawiasz, że automatyzacja uruchamia się tylko wtedy, gdy dane się zgadzają. Tak uruchamiasz ją na przykład tylko dla przyczep stacjonarnych albo tylko dla faktur powyżej jakiejś kwoty. Zostaw puste, aby uruchamiać przy każdym zdarzeniu tego typu.

1. Kliknij Dodaj warunek
2. Wybierz pole przyciskiem Zmienna (albo wpisz ścieżkę, na przykład invoice.status)
3. Wybierz sposób porównania
4. Wpisz wartość. Przy polach o stałym wyborze, takich jak status, typ terenu czy kolega, wybierasz z listy

Możesz użyć następujących porównań:

Wielkość liter nie ma znaczenia. Liczby są porównywane jako liczby, więc 10 jest większe niż 9.

Jeśli masz więcej niż jeden warunek, wybierasz, jak współpracują: Wszystkie muszą być spełnione albo Wystarczy jeden spełniony.

Uruchom raz na rekordKopiuj link do tej sekcji

Z Uruchom raz na rekord automatyzacja uruchamia się najwyżej raz na fakturę, rezerwację lub inny rekord, bez względu na to, jak często zdarzenie dla niego wystąpi.

Jest to przydatne zwłaszcza przy zdarzeniach, które często wracają, jak invoice:updated: faktura jest zmieniana dziesiątki razy, a Ty chcesz wysłać tylko jedno przypomnienie. Tillor zapamiętuje dla każdego rekordu, że automatyzacja już się uruchomiła. To zapamiętanie znika, gdy usuniesz automatyzację.

Działa to tylko przy zdarzeniach, do których należy rekord, oraz przy Faktura przeterminowana i Nadeszła data. Przy Nadeszła data oznacza to: nawet jeśli data później się przesunie, przepływ nie uruchomi się ponownie. Przy harmonogramie takim jak Codziennie o danej godzinie nie ma to efektu.

Co dzieje się potem?Kopiuj link do tej sekcji

• Za każdym razem, gdy nadchodzi moment startu i filtr się zgadza, uruchamia się wykonanie z danymi z tej chwili jako zmiennymi.
• Zdarzenie uruchamia się od razu. Data, godzina lub harmonogram uruchamia się w minucie, w której przychodzi jego kolej.
• Jeśli filtr nie pasuje, nic się nie uruchamia i na karcie Uruchomienia nie ma żadnego śladu.

Problemy?Kopiuj link do tej sekcji

Czytaj dalejKopiuj link do tej sekcji