Przejdź do treści

Powiadomienia przez webhooki

Wysyłaj podpisaną wiadomość do innej aplikacji, gdy faktura zostanie wystawiona, płatność zaksięgowana, zapas spadnie do niskiego poziomu i w innych sytuacjach.

Czas czytania: 5 min Prawdziwe ekrany, fikcyjne dane przykładowe Zaktualizowano 22 października 2026

Na tej stronie

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

  1. Krok 1: Dodaj endpoint

    W Administracja → Ustawienia → API i webhooki, w sekcji Webhooki, kliknij Dodaj endpoint.

  2. Krok 2: Wpisz adres

    Wypełnij URL endpointu (musi to być publiczny adres https://) i opcjonalnie Opis.

  3. Krok 3: Wybierz zdarzenia

    W sekcji Zdarzenia zaznacz potrzebne lub Wszystkie zdarzenia, w tym dodane później.

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

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

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ą
Czat z AI