Webhook to wiadomość, którą wysyłamy metodą POST na adres Twojej aplikacji, gdy coś wydarzy się w firmie, dzięki czemu druga aplikacja nie musi ciągle odpytywać.
-
Krok 1: Dodaj endpoint
W Administracja → Ustawienia → API i webhooki, w sekcji Webhooki, kliknij Dodaj endpoint.
-
Krok 2: Wpisz adres
Wypełnij URL endpointu (musi to być publiczny adres https://) i opcjonalnie Opis.
-
Krok 3: Wybierz zdarzenia
W sekcji Zdarzenia zaznacz potrzebne lub Wszystkie zdarzenia, w tym dodane później.
-
Krok 4: Skopiuj sekret podpisu
Po zapisaniu Sekret podpisu jest wyświetlany tylko raz. Skopiuj go do aplikacji odbierającej, aby mogła sprawdzić, czy każda wiadomość naprawdę pochodzi od nas.
-
Krok 5: Przetestuj
Kliknij Wyślij zdarzenie testowe i sprawdź Dziennik doręczeń.
Dostępne zdarzenia
- Kontakty: kontakt został utworzony lub zaktualizowany.
- Faktury: wystawiona, opłacona w całości, unieważniona. Oferty: zaakceptowana.
- Płatności: zaksięgowano płatność lub wpłatę.
- Faktury zakupowe: otrzymana (zaksięgowana), opłacona w całości. Wydatki: zarejestrowano wydatek.
- Zapasy: stan pozycji spadł do poziomu ponownego zamówienia lub poniżej.
- Urlopy: utworzono wniosek urlopowy.
Doręczenia i ponowne próby
- Twoja aplikacja powinna odpowiedzieć statusem 2xx w ciągu 10 sekund. Wszystko inne jest traktowane jako niepowodzenie.
- Nieudane doręczenia są automatycznie ponawiane, maksymalnie sześć prób w ciągu kilku godzin, z coraz dłuższymi odstępami.
- Otwórz endpoint przyciskiem Zarządzaj, aby zobaczyć Dziennik doręczeń: każde zdarzenie z jego polem Ładunek, Odpowiedź Twojego serwera i statusem Dostarczono, Nieudana lub Oczekujące. Kliknij Wyślij ponownie, aby wysłać je jeszcze raz.
- Odznacz Wysyłaj zdarzenia do tego endpointu, aby go wstrzymać, lub kliknij Usuń, aby go usunąć. Endpoint, który przez długi czas zwraca błędy, zostaje automatycznie wyłączony.
Weryfikacja podpisu
Każde doręczenie zawiera nagłówek X-Webhook-Signature: t=<timestamp>,v1=<signature>. Oblicz HMAC-SHA256 z „<timestamp>.<raw body>” przy użyciu sekretu podpisu i porównaj z v1; odrzucaj znaczniki czasu starsze niż 5 minut. X-Webhook-Id pozostaje taki sam przy ponownych próbach, więc używaj go do ignorowania duplikatów.
Powiązane poradniki
Zapytaj o produkt
Zapytaj, co potrafi oprogramowanie, jak działa dane zadanie lub jakie kraje i języki obsługuje. Odpowiedzi pochodzą z tych poradników.
Myślę…
Asystent AI jest w tej chwili niedostępny. Przeszukaj przewodniki lub porozmawiaj z naszym zespołem. Kontakt z pomocą techniczną
AI może popełniać błędy. Sprawdź podlinkowane poradniki.
Nadal potrzebujesz pomocy?
Nasz zespół wsparcia czyta każdą wiadomość i odpowiada prostym językiem.
Kontakt z pomocą techniczną