Webhook

Definicja

Webhook (lub "callback HTTP") to mechanizm, za pomocą którego system automatycznie przesyła żądanie HTTP POST pod skonfigurowany adres URL w momencie wystąpienia zdarzenia (np. nowe zamówienie, wystawienie faktury, potwierdzenie dostawy).

Dlaczego jest lepszy od pollingu?

• REST polling: odpytywanie API co 1-5 minut pytaniem "czy jest coś nowego?" → 12-60 bezużytecznych wywołań na godzinę.

• Webhook: powiadomienie w czasie poniżej 1 sekundy od zmiany → 0 zbędnych zapytań, minimalne opóźnienie (latency).

Zdarzenia CRMconnect obsługiwane przez webhooki

• order.created / order.shipped / order.delivered (statusy zamówień)

• invoice.issued / invoice.paid (fakturowanie i płatności)

• inventory.low_stock / inventory.reserved (stany magazynowe)

• partner.created / partner.updated (dane kontrahentów w CRM)

• chargeback.received (zwroty płatności)

Najlepsze praktyki dla odbiorcy webhooka

• Szybka odpowiedź HTTP 200 (poniżej 5 sek.) i przetwarzanie asynchroniczne.

• Weryfikacja sygnatury (HMAC) w celu zapewnienia bezpieczeństwa.

• Idempotentność: obsługa sytuacji, w której to samo zdarzenie może zostać dostarczone więcej niż raz.