Webhooky

Co to je

Webhook je opak běžného dotazu na API. Místo toho, aby se ERP každých pět minut ptalo e-shopu „máš novou objednávku?", pošle e-shop zprávu sám, jakmile objednávka vznikne. Technicky jde o obyčejný HTTP POST na adresu, kterou si předem zaregistrujete. V těle je JSON s informací o události.

Díky tomu se změny propisují během sekund a zbytečně se nezatěžuje API. Webhooky nabízí většina platforem, se kterými pracujeme: Shopify, WooCommerce, Shoptet (přes API, tedy u API partnerů a Shoptet Premium), platební brány i dopravci.

Jak to funguje

1. Registrace. V administraci nebo přes API zadáte událost a cílovou URL. U Shoptetu například událost order:create a adresu vašeho serveru.
2. Událost. Zákazník dokončí objednávku a platforma odešle POST na vaši URL.
3. Ověření. Příjemce zkontroluje, že zpráva opravdu přišla od platformy. Shopify posílá podpis HMAC-SHA256 v hlavičce X-Shopify-Hmac-SHA256, WooCommerce v hlavičce X-WC-Webhook-Signature. Shoptet posílá notifikace z pevného rozsahu IP adres.
4. Rychlé potvrzení. Příjemce odpoví stavovým kódem 2xx. Na odpověď se čeká jen krátce — Shopify 5 sekund, Shoptet 4 sekundy (podle dokumentace k 9/2026). Proto se zpráva jen uloží do fronty a zpracuje se až potom.
5. Zpracování. Samotná práce (zápis do ERP, e-mail, rezervace skladu) běží na pozadí.

Důležitý detail: webhook často nenese celá data. Shoptet posílá jen typ události, čas a identifikátor, třeba číslo objednávky. Detail si příjemce dotáhne přes API.

Výhody a limity

Výhody

• Reakce v řádu sekund místo minut nebo hodin.
• Menší zátěž API a nižší riziko, že narazíte na limity počtu požadavků.
• Jednoduché spouštění automatizací v nástrojích jako n8n.

Limity a na co si dát pozor

• Doručení není zaručené. Když je váš server zrovna mimo, platforma to chvíli zkouší znovu a pak to vzdá. Shopify doručení opakuje 8× během 4 hodin. WooCommerce po 5 neúspěšných doručeních po sobě webhook vypne a musí se znovu zapnout. Bez kontroly o tom nikdo neví.
• Duplicity. Stejná událost může dorazit víckrát. Zpracování musí být idempotentní — druhé doručení nesmí vytvořit druhou fakturu.
• Pořadí. Zprávy nemusí přijít ve stejném pořadí, v jakém události vznikly. Proto se před zápisem ověřuje aktuální stav přes API.
• Bezpečnost. Bez ověření podpisu může na vaši URL poslat „objednávku" kdokoli.

Robustní řešení proto kombinuje webhook (rychlost) s pravidelnou kontrolou přes API (úplnost) a frontou zpráv mezi příjmem a zpracováním.

Jak to řešíme v Převeďshopu

Webhooky nasazujeme tam, kde záleží na čase: objednávky do ERP, platby, stavy zásilek, skladové pohyby. Konkrétně:

1. Navrhneme tok událostí — které události odebírat, co se má stát a co když cílový systém neodpovídá.
2. Postavíme příjem s ověřením podpisu, frontou a idempotentním zpracováním. Buď jako vlastní službu, nebo v n8n. Detail na stránce Integrace a middleware.
3. Doplníme pojistku. Pravidelná kontrola přes API dohledá, co webhook nedoručil, a upozorní na vypnuté nebo selhávající odběry.
4. Napojíme to na další procesy — ERP, účetnictví, sklad, e-mailing. Viz Automatizace a realtime synchronizace.

Příklady z praxe najdete v článku Webhooky v ecommerce — praktické využití. Cenu připravíme po konzultaci podle počtu událostí a napojených systémů.