Webhooks w Shoper to mechanizm powiadomień w czasie rzeczywistym — pozwalają sklepowi automatycznie wysyłać informacje o zdarzeniach (nowe zamówienie, zmiana statusu, nowy klient) do zewnętrznych systemów bez konieczności cyklicznego odpytywania API. Dzięki webhookom integracje z ERP, systemami magazynowymi czy platformami marketingowymi reagują natychmiastowo na zmiany w sklepie.
Serwis Wiatraczna pomaga właścicielom sklepów Shoper skonfigurować i przetestować webhooks — zarówno przy wdrażaniu własnych integracji, jak i przy diagnostyce problemów z aplikacjami, które powinny reagować na zdarzenia sklepowe, a nie działają poprawnie.
Webhooks w Shoper — jak działają i do czego służą?
Webhook to skonfigurowany adres URL (endpoint) na zewnętrznym serwerze, na który Shoper wysyła żądanie HTTP POST w momencie wystąpienia określonego zdarzenia w sklepie. Payload żądania zawiera dane o zdarzeniu — np. numer zamówienia, status, dane klienta. System na końcu webhooka odbiera dane i wykonuje odpowiednią akcję — np. tworzy dokument w systemie ERP lub aktualizuje stan w magazynie.
Konfiguracja webhooków w panelu Shoper
Webhooks konfiguruje się w panelu Shoper w sekcji poświęconej API lub integracjom. Dla każdego webhooka określa się: adres URL endpointu, typ zdarzenia wyzwalającego (np. order/create, order/update, product/update) oraz opcjonalnie nagłówki autoryzacyjne, które Shoper dołącza do każdego żądania. Warto skonfigurować weryfikację podpisów webhooka, jeśli zewnętrzny endpoint to obsługuje, co chroni przed fałszywymi wywołaniami.
Testowanie webhooków i debugowanie
Testowanie webhooków wymaga publicznego dostępu do endpointu — Shoper nie może wysłać żądania na adres localhost ani wewnętrzną sieć firmy. Do testów można użyć narzędzi takich jak Webhook.site lub RequestBin, które przechwytują i wyświetlają przychodzące żądania. Jeśli webhook nie działa, warto sprawdzić logi błędów po stronie Shoper (panel aplikacji) i zweryfikować, czy endpoint odpowiada kodem HTTP 200 w ciągu 5 sekund.
Obsługa błędów i ponowne wysyłanie
Jeśli endpoint nie odpowie w oczekiwanym czasie lub zwróci kod błędu (4xx, 5xx), Shoper ponawia próbę wysłania webhooka zgodnie ze skonfigurowaną polityką retry. Brak obsługi ponawiania po stronie endpointu może prowadzić do duplikatów zdarzeń — dlatego implementując obsługę webhooków, warto stosować idempotentne operacje i deduplikację przez unikalny identyfikator zdarzenia.
Typowe zastosowania webhooków w praktyce
Najczęstsze zastosowania webhooków to: automatyczne tworzenie dokumentów w systemie ERP przy nowym zamówieniu, powiadamianie magazynu o zamówieniach do wysyłki, aktualizacja CRM przy rejestracji nowego klienta, wyzwalanie kampanii e-mail marketingowych przy określonych statusach zamówień oraz integracja z systemami analitycznymi śledzącymi zdarzenia sprzedażowe w czasie rzeczywistym.
Konfiguracja webhooków Shoper — pomoc techniczna
Serwis Wiatraczna pomaga konfigurować i diagnozować problemy z webhookami w sklepach Shoper. Skontaktuj się z nami — zapewnimy sprawne działanie automatycznych powiadomień i integracji opartych na zdarzeniach.
