Powiadomienia wychodzące (webhooki)

Odbieranie zdarzeń z PowerHub zamiast odpytywania API w pętli. Zamiast raz po raz pytać, czy coś się zmieniło, rejestrujesz adres, na który PowerHub sam wyśle powiadomienie w chwili zdarzenia.

Rejestracja adresu

Adres odbierający zdarzenia rejestrujesz przez API (zasób powiadomień wychodzących) albo w panelu. Do każdego adresu przypisujesz listę zdarzeń, którymi jesteś zainteresowany.

Przykładowy ładunek powiadomienia o zmianie statusu zamówienia:

{
  "event": "order.status_changed",
  "occurredAt": "2026-07-24T10:15:00.000Z",
  "data": {
    "orderId": "...",
    "number": "ZAM/2026/07/1234",
    "status": "shipped"
  }
}

Wymagania po stronie odbiorcy

• Odpowiadaj kodem 2xx możliwie szybko, a długie przetwarzanie wykonuj asynchronicznie, po potwierdzeniu odbioru.
• Obsłuż powtórzenia: to samo zdarzenie może dotrzeć więcej niż raz. Rozpoznawaj je po identyfikatorze zdarzenia.
• Nie zakładaj kolejności, bo zdarzenia mogą dotrzeć w innej kolejności, niż wystąpiły.
• Weryfikuj pochodzenie żądania sekretem ustalonym przy rejestracji adresu.

Kiedy zamiast webhooka użyć automatyzacji

Jeżeli potrzebujesz wysłać dane do zewnętrznego systemu w reakcji na konkretną sytuację biznesową, na przykład tylko zamówienia powyżej pewnej kwoty, prościej użyć akcji webhook w regule automatyzacji. Masz wtedy pełne warunki i kontrolę nad treścią żądania.

Zobacz też