Webhook

Co je Webhook?

Webhook (také HTTP callback nebo reverse API) je mechanismus, ve kterém systém sám pošle HTTP POST požadavek do předem zadané URL adresy, když v něm nastane definovaná událost — nová faktura, změna stavu objednávky, příchod platby. Je to opak klasického API volání, kde se klient ptá serveru („máš něco nového?”). Webhook je push, klasický API dotaz je pull.

Výhody webhooků:

• Real-time — událost je doručena okamžitě, bez periodického pollingu
• Efektivita — nezatěžují oba systémy prázdnými voláními
• Jednoduchost — konfigurace bývá jen URL + autentizační token

Typické problémy, na které je třeba myslet při implementaci webhooku:

• Autentizace — přidat HMAC signaturu nebo token, aby se ověřil odesílatel
• Retry logika — pokud cílový systém odpoví chybou (5xx), zkus znovu s exponenciálním backoffem
• Idempotence — cílový systém musí vědět, že stejnou událost může dostat dvakrát
• Order of delivery — webhooky nemusí přijít v pořadí

V českém SaaS ekosystému jsou webhooky standardem — Stripe, Shopify, Mailchimp a dalším e-commerce integrace všechny používají webhook model.

Kdy se používá

Webhooky jsou vhodné pro:

• Synchronizaci mezi systémy (ERP ↔ e-shop)
• Spuštění workflow automatizace při události
• Notifikace do komunikačních kanálů (Slack, Teams)
• Real-time dashboardy

Viz stránku API, modul Pracovní postupy a integrace.

Související pojmy

• API — klasický request/response model. Viz /cs/slovnik/api.
• Workflow automation — webhooky jsou typickým triggerem. Viz /cs/slovnik/workflow-automation.
• MCP — alternativní protokol pro AI asistenty. Viz /cs/slovnik/mcp.

V Modulario

Modulario vystavuje konfigurovatelné webhooky pro každou klíčovou událost — vytvoření faktury, uzavření dealu, změnu stavu objednávky. Automatický retry se signaturou zajišťuje spolehlivé doručení. Příklady a schémata na /api.

Modulario poskytuje webhook management UI, kde administrátor vidí všechny aktivní registrace, logy posledních 1 000 volání (včetně payloadu a odpovědi) a dokáže spustit „replay” pro doručení událostí po výpadku cílového systému.