Webhooks - Shifton Help

Webhooks pozwalają Shifton wysyłać powiadomienia w czasie rzeczywistym do systemów zewnętrznych przy wystąpieniu zdarzeń w firmie.

Instrukcja krok po kroku

Dostęp do zakładki Webhooks

W lewym panelu bocznym kliknij Integracje.

Przejdź do strony Deweloper → zakładka Webhooki.

Tworzenie nowego webhook

Kliknij «Nowy webhook».

Wypełnij konfigurację:

Pole	Opis
URL	Punkt końcowy do odbierania danych zdarzeń
Wydarzenia	Zdarzenia Shifton aktywujące webhook
Aktywny	Przełącznik włączenia/wyłączenia

Zapisz. Shifton będzie wysyłał żądania HTTP POST na wskazany URL.

Zarządzanie webhooks

Kliknij webhook, aby edytować URL, zaktualizować zdarzenia lub zmienić status aktywności.

Testowanie webhook

Wywołaj odpowiednie zdarzenie w Shifton (np. utwórz testową zmianę).

Sprawdź logi serwera — dane powinny wpłynąć.

Powiązane artykuły

Najczęściej zadawane pytania

P: W jakim Utwórzacie warstwaon wysyła dane?
HTTP POST z treścią w formacie JSON. Strukturę danych dla każdego typu zdarzenia można znaleźć w dokumentacji API.

P: Czy można utworzyć kilka Webhooki dla jednego zdarzenia?
Tak, z różnymi URL.

P: Co jeśli serwer jest niedostępny w momencie wyzwolenia webhook?
Dostarczenie może się nie powieść. Szczegóły dotyczące polityki ponownych prób — w dokumentacji API.

P: Webhook nie wyzwala się — dlaczego?
Upewnij się, że przełącznik Aktywny jest włączony i URL jest publicznie dostępny.

P: Jak sprawdzić, czy webhook odbiera dane?
Utwórz zdarzenie testowe w Shifton (np. dodaj zmianę) i sprawdź logi serwera pod kątem przychodzącego żądania POST.

P: Czy mogę skonfigurować uwierzytelnianie webhook?
Tak. Należy dodać klucz tajny lub token do URL lub nagłówków webhook. Szczegóły w dokumentacji API.

P: Jak wygląda treść żądania webhook?
Obiekt JSON z danymi zdarzenia. Struktura zależy od typu zdarzenia — szczegóły w dokumentacji API.

P: Czy jeden webhook może śledzić kilka zdarzeń?
Tak. Przy tworzeniu webhook należy wybrać kilka zdarzeń — jeden URL będzie odbierał powiadomienia o wszystkich wybranych.

P: Co to jest «polityka ponownych prób» dla webhook?
Jeśli serwer zwraca błąd (nie 200), Shifton może ponowić żądanie. Szczegóły zależą od konfiguracji platformy.

P: Czy jest Granica liczby Webhooki?
Ograniczeń ilościowych w dokumentacji nie wskazano, ale zaleca się tworzenie tylko niezbędnych.

P: Czy URL webhook musi być HTTPS?
Zalecane. Adresy HTTP mogą działać, ale HTTPS zapewnia bezpieczny transfer danych.

P: Czy można otrzymywać powiadomienia webhook przy każdej zmianie harPonogramu?
Tak. Należy dodać zdarzenia typu «Warstwa utworzona» lub «schedule updated» przy konfiguracji webhook.

P: Kto ma dostęp do tworzenia Webhooki?
Tylko Właściciel. Menedżerowie i Pracownicy nie widzą sekcji Developer.

P: Czy można wyłączyć webhook bez usuwania go?
Tak. Należy wyłączyć przełącznik Aktywny w ustawieniach webhook — przestanie się wyzwalać, ale zachowa konfigurację.

P: Czy wyzwolenia webhook są logowane w warstwaon?
Szczegółowe logi dostarczania webhook w interfejsie nie są udostępniane. Śledzenie — po stronie serwera.

P: Czy można filtrować webhook Jaług projektu lub harPonogramu?
Nie. Webhook wyzwala się na wszystkie zdarzenia wybranego typu w całej firmie. Filtrowanie — po stronie serwera odbiorczego.

P: Co dzieje się z webhook przy uRównieżięciu firmy?
Wszystkie webhooks są usuwane wraz z firmą.