Integracje
Wyślij webhook albo wywołaj API z automatyzacji.
Ostatnio zaktualizowano
Te kroki znajdują się w grupie Integracje. Nieudane dostarczenie idzie dalej przez Niepowodzenie. W przypadku innych akcji przeczytaj Gdy krok się nie uda.
Wyślij webhook
Dostarcza własną wiadomość do jednego z punktów końcowych webhooków Twojej organizacji. Przydaje się, żeby powiadomić inny system, na przykład kasę albo stronę internetową.
| Pole | Co wpisujesz |
|---|---|
| Punkt końcowy | Wybierz jeden ze swoich punktów końcowych webhooków. Rozpoznasz je po adresie. Wymagane |
| Nazwa zdarzenia | Nazwa dołączana do wiadomości, żeby odbiorca mógł ją rozpoznać, na przykład automation.invoice_unpaid. Wymagane |
| Ładunek | Treść wiadomości w formacie JSON. Zmienne są uzupełniane przed wysłaniem wiadomości. Wymagane |
Punkty końcowe tworzysz i zarządzasz nimi w menu profilu w sekcji Dla deweloperów. Punkt końcowy musi istnieć i być włączony. Jeśli tak nie jest, krok się nie udaje i wykonanie zostaje zatrzymane.
Wiadomość jest podpisywana własnym kluczem punktu końcowego, dokładnie tak jak inne webhooki, które ten punkt odbiera. Tillor ponawia próbę kilka razy, jeśli Twój serwer nie odpowie poprawnie. Punkt końcowy nie musi śledzić nazwy Twojego zdarzenia: wiadomość i tak dotrze.
Krok ma dwa wyjścia:
| Wyjście | Kiedy |
|---|---|
| Powodzenie | Twój serwer odpowiedział statusem sukcesu |
| Niepowodzenie | Dostarczenie nie udało się po wszystkich próbach. Potem wiadomość jest jeszcze ponawiana w tle, tak jak zwykły webhook |
Szablon Przekazuj rezerwacje do innego systemu używa wyjścia Niepowodzenie, żeby utworzyć zadanie, które ktoś podejmie.
Ładunek wygląda na przykład tak:
{
"reservation": "{reservation.displayId}",
"checkIn": "{reservation.checkIn}",
"adults": {reservation.numberOfAdults},
"customer": {
"firstName": "{reservation.customer.firstName}",
"email": "{reservation.customer.email}"
}
}Tekst ujmij w cudzysłów, a liczby wpisz bez niego. Daty w JSON trafiają jako międzynarodowa data i godzina, na przykład 2026-10-05T08:00:00.000Z. Szczegóły przeczytasz w Zmienne i szablony. Stronę techniczną, na przykład budowę wiadomości, opisano w Dla deweloperów > Automatyzacje.
Żądanie API
Wywołuje API Tillor Twojej własnej organizacji albo inny adres w internecie. Dzięki temu zrobisz prawie wszystko, co potrafi Tillor, i wyszukasz dane, żeby coś z nimi zrobić.
W polu Wyślij do wybierasz między Tillor API a Własny URL. W polu Metoda wybierasz GET (pobieranie), POST (tworzenie), PUT lub PATCH (zmienianie) albo DELETE (usuwanie).
Tillor API
| Pole | Co wpisujesz |
|---|---|
| Ścieżka | Część adresu po API Twojej organizacji, na przykład /tasks albo /tasks/{task.id}. Musi zaczynać się od /. Wymagane |
| Treść | Dane, które wysyłasz, w formacie JSON. Zostaw puste, jeśli nic nie wysyłasz |
Na górze pola znajduje się Wybierz punkt końcowy API. Kliknij go i szukaj na liście, na przykład tasks. Gdy wybierzesz punkt końcowy, Tillor uzupełnia metodę i ścieżkę. Jeśli Treść jest jeszcze pusta, dostajesz też przykład tego, czego punkt końcowy oczekuje. Nazwy w nawiasach klamrowych w ścieżce zastąp zmiennymi z wcześniejszych kroków. Jeśli są parametry zapytania, zobaczysz je pod polem.
Wywołanie odbywa się jako użytkownik Przepływ pracy i nigdy nie może wyjść poza Twoją organizację. Automatyzacja nie może zarządzać automatyzacjami, więc wywołania, które dotyczą automatyzacji lub ich wykonań, są odrzucane.
Własny URL
| Pole | Co wpisujesz |
|---|---|
| URL | Adres. Musi zaczynać się od https://. Wymagane |
| Nagłówki | Dodatkowe dane dla odbiorcy, na przykład klucz. Kliknij Dodaj nagłówek i wypełnij Nazwa oraz Wartość |
| Treść | Dane, które wysyłasz, w formacie JSON. Zostaw puste, jeśli nic nie wysyłasz |
Obowiązują tu te zasady:
- Adresy bez
https://są odrzucane - Adresy prywatne i wewnętrzne są odrzucane, także gdy wskazuje na nie zwykła nazwa
- Przekierowania nie są śledzone. Jeśli serwer odpowie przekierowaniem, liczy się to jako Niepowodzenie
- Nagłówki są zapisywane w formie zaszyfrowanej. Możesz więc wpisać w nich klucz lub token
- Przy GET i DELETE treść nie jest wysyłana
Wyjścia i odpowiedź
Żądanie ma dwa wyjścia: Powodzenie (serwer odpowiedział statusem sukcesu) i Niepowodzenie (serwer odpowiedział statusem błędu). Jeśli Tillor w ogóle nie dotrze do serwera, na przykład przez przekroczenie czasu po 15 sekundach albo odrzucony adres, wykonanie zatrzymuje się ze statusem Niepowodzenie.
Dla kolejnych kroków są trzy zmienne:
| Zmienna | Zawartość |
|---|---|
{response.status} | Kod statusu, na przykład 200 |
{response.body} | Odpowiedź jako tekst, skrócona do pierwszych 4000 znaków |
{response.data} | Odpowiedź jako dane, dzięki czemu możesz wyciągać z niej pola, na przykład {response.data.items.0.id} |
Jak z tego korzystać, opisano w Używanie odpowiedzi API. Pełny przykład z wyszukiwaniem znajdziesz w Kontrola przyczepy do wynajęcia.