Webhook

Czym jest Webhook?

Webhook (też HTTP callback lub reverse API) to mechanizm, w którym system sam wysyła żądanie HTTP POST na wcześniej podany adres URL, gdy w nim nastąpi zdefiniowane zdarzenie — nowa faktura, zmiana statusu zamówienia, nadejście płatności. Jest to odwrotność klasycznego wywołania API, gdzie klient pyta serwera („masz coś nowego?”). Webhook to push, klasyczne zapytanie API to pull.

Zalety webhooków:

• Czas rzeczywisty — zdarzenie dostarczane jest natychmiast, bez okresowego pollingu
• Efektywność — nie obciążają obu systemów pustymi wywołaniami
• Prostota — konfiguracja to zazwyczaj tylko URL + token uwierzytelniający

Typowe problemy do uwzględnienia przy implementacji webhooków:

• Uwierzytelnianie — dodanie sygnatury HMAC lub tokenu w celu weryfikacji nadawcy
• Logika retry — jeśli system docelowy odpowie błędem (5xx), spróbuj ponownie z wykładniczym backoffem
• Idempotentność — system docelowy musi wiedzieć, że to samo zdarzenie może otrzymać dwukrotnie
• Kolejność dostarczenia — webhooki mogą nie docierać w kolejności

W polskim ekosystemie SaaS webhooki są standardem — Stripe, Shopify, Mailchimp, Fakturownia, Przelewy24 — wszystkie integracje używają modelu webhooka.

Kiedy ma zastosowanie

Webhooki są odpowiednie dla:

• Synchronizacji między systemami (ERP ↔ sklep internetowy)
• Uruchamiania automatyzacji workflow przy zdarzeniu
• Powiadomień do kanałów komunikacyjnych (Slack, Teams)
• Dashboardów czasu rzeczywistego

Zob. stronę API, moduł Procesy robocze i integracje.

Powiązane pojęcia

• API — klasyczny model request/response. Zob. /pl/slownik/api.
• Workflow automation — webhooki są typowym triggerem. Zob. /pl/slownik/workflow-automation.
• MCP — alternatywny protokół dla asystentów AI. Zob. /pl/slownik/mcp.

W Modulario

Modulario wystawia konfigurowalne webhooki dla każdego kluczowego zdarzenia — tworzenie faktury, zamknięcie deala, zmiana statusu zamówienia. Automatyczny retry z sygnaturą zapewnia niezawodne dostarczanie. Przykłady i schematy na /api.

Modulario dostarcza interfejs zarządzania webhookami, w którym administrator widzi wszystkie aktywne rejestracje, logi ostatnich 1 000 wywołań (w tym payload i odpowiedź) i może uruchomić „replay” dla dostarczenia zdarzeń po awarii systemu docelowego.