Webhook

Čo je Webhook?

Webhook (tiež HTTP callback alebo reverse API) je mechanizmus, v ktorom systém sám pošle HTTP POST požiadavku do vopred zadanej URL adresy, keď v ňom nastane definovaná udalosť — nová faktúra, zmena stavu objednávky, príchod platby. Je to opak klasického API volania, kde sa klient pýta servera („máš niečo nové?”). Webhook je push, klasický API dotaz je pull.

Výhody webhookov:

• Real-time — udalosť je doručená okamžite, bez periodického pollingu
• Efektivita — nezaťažujú oba systémy prázdnymi volaniami
• Jednoduchosť — konfigurácia býva len URL + autentizačný token

Typické problémy, na ktoré treba myslieť pri implementácii webhooku:

• Autentizácia — pridať HMAC signatúru alebo token, aby sa overil odosielateľ
• Retry logika — ak cieľový systém odpovie chybou (5xx), skús znova s exponenciálnym backoffom
• Idempotencia — cieľový systém musí vedieť, že tú istú udalosť môže dostať dvakrát
• Order of delivery — webhooky nemusia prísť v poradí

V slovenskom SaaS ekosystéme sú webhooky štandardom — Stripe, Shopify, Mailchimp, SuperFaktúra či e-kasa integrácie všetky používajú webhook model.

Kedy sa používa

Webhooky sú vhodné pre:

• Synchronizáciu medzi systémami (ERP ↔ e-shop)
• Spustenie workflow automatizácie pri udalosti
• Notifikácie do komunikačných kanálov (Slack, Teams)
• Real-time dashboardy

Pozri stránku API, modul Pracovné postupy a integrácie.

Súvisiace pojmy

• API — klasický request/response model. Pozri /slovnik/api.
• Workflow automation — webhooky sú typickým triggerom. Pozri /slovnik/workflow-automation.
• MCP — alternatívny protokol pre AI asistentov. Pozri /slovnik/mcp.

V Modulariu

Modulario vystavuje konfigurovateľné webhooky pre každú kľúčovú udalosť — vytvorenie faktúry, uzavretie deal-u, zmenu stavu objednávky. Automatický retry so signatúrou zabezpečuje spoľahlivé doručenie. Príklady a schémy na /api.

Modulario poskytuje webhook management UI, kde administrátor vidí všetky aktívne registrácie, logy posledných 1 000 volaní (vrátane payloadu a odpovede) a dokáže spustiť „replay” pre doručenie udalostí po výpadku cieľového systému.