Webhooks

Webhooks to wzorzec integracji, w którym zewnętrzny system wysyła żądanie HTTP (najczęściej POST) na znany endpoint Twojej aplikacji, gdy zajdzie zdarzenie — np. nowa płatność, zapis na newsletter, zmiana statusu zamówienia. Payload bywa w JSON z nagłówkami metadanymi. Weryfikacja podpisu (np. HMAC współdzielonym sekretem) jest standardem ochrony przed fałszerstwem.

W stacku marketingowym webhooks łączą CRM, narzędzia e-mail, platformy reklamowe, sklepy i systemy analityczne, automatyzując lejek bez ręcznego eksportu CSV. Ważne są: idempotencja po identyfikatorze zdarzenia, kolejka po stronie odbiorcy, retry z wykładniczym backoff oraz szybka odpowiedź 2xx (z dalszym przetwarzaniem asynchronicznym). Dokumentuj schemat payloadu i wersjonowanie zdarzeń.

Transparentność wobec partnerów i regulatorów: jasno określ, jakie dane osobowe przepływają webhookami, jak długo je logujesz i kto ma dostęp do sekretów podpisujących — to element architektury zgodności, nie tylko techniczny szczegół.