+420 728 089 029EN

Co je webhook a jak se liší od API

Webhook je automatická zpráva, kterou jeden systém pošle na zadanou adresu ve chvíli, kdy se v něm něco stane: přijde nová objednávka, změní se stav nebo někdo odešle formulář. Druhý systém se tak nemusí pořád ptát, jestli je něco nového.

Webhook a API

Rozdíl jde vysvětlit na doručení balíku. API je, když do výdejny voláte, jestli už balík dorazil. Webhook je SMS, kterou vám výdejna pošle sama, jakmile tam balík je.

Technicky webhook znamená, že systém při události pošle požadavek (obvykle POST s daty ve formátu JSON) na adresu, kterou mu nastavíte. Na té adrese čeká váš skript nebo automatizační nástroj a zprávu zpracuje.

Kde se s webhooky potkáte

  • Shoptet Premium: přes API si zaregistrujete webhooky na události, jako je nová objednávka, změna produktu, skladový pohyb nebo vystavený doklad.
  • Formuláře: náš doplněk Kontaktní formuláře umí po odeslání poslat data webhookem dál, třeba do Google Sheets, CRM nebo do nástroje na automatizace.
  • Automatizační nástroje: n8n, Make nebo Zapier mají webhook jako běžný spouštěč scénáře.

Na co myslet

  • Adresa, na kterou webhook míří, musí být dostupná a odpovídat rychle. Náročné zpracování patří až za přijetí zprávy.
  • Ověřujte, že zpráva přišla opravdu od správného odesílatele.
  • Počítejte s tím, že zpráva může výjimečně přijít dvakrát nebo vypadnout. Důležitá data je dobré občas srovnat přes API.

Příklad z praxe e-shopu

Při každé nové objednávce pošle Shoptet webhook do n8n. Scénář si přes API dotáhne detail objednávky, a pokud je nad 10 000 Kč, pošle obchodníkovi zprávu, aby zákazníkovi zavolal a poděkoval. Nikdo nemusí hlídat administraci a velké objednávky se neztratí v běžném provozu.

Zpět na slovník pojmů