Skip to Content
AutomatyzacjeAkcje

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ą.

PoleCo wpisujesz
Punkt końcowyWybierz jeden ze swoich punktów końcowych webhooków. Rozpoznasz je po adresie. Wymagane
Nazwa zdarzeniaNazwa dołączana do wiadomości, żeby odbiorca mógł ją rozpoznać, na przykład automation.invoice_unpaid. Wymagane
ŁadunekTreść 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ścieKiedy
PowodzenieTwój serwer odpowiedział statusem sukcesu
NiepowodzenieDostarczenie 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

PoleCo wpisujesz
ŚcieżkaCzęść 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

PoleCo wpisujesz
URLAdres. Musi zaczynać się od https://. Wymagane
NagłówkiDodatkowe 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:

ZmiennaZawartość
{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.

Czy ta strona była pomocna?

Na tej stronie