Automatizace
n8n: automatizace, kterou si hostujete sami
Stejné napojení jako u Make, jen ve vašem n8n. Uzel Webhook přijme události, uzel HTTP Request si dotáhne data z obchodu.
01Co si předáváte
Konkrétně
- Jak se napojí
- Uzel Webhook, metoda POST
- Události
- 14 typů, vybíráte je zaškrtnutím
- Podpis
- HMAC-SHA256, otevřený Standard Webhooks
- Ověření
- Uzel Code, se zapnutým Raw Body
- Doručení
- Nejméně jednou, s rostoucími odstupy
- Data z obchodu
- Uzel HTTP Request proti našemu API
02Zapnutí
Jak to spustíte
Tři kroky. Delší návod by znamenal, že jsme něco neudělali za vás.
Přidejte uzel Webhook
Metodu nastavte na POST a zapněte Raw Body. Bez surového těla nejde podpis ověřit, protože přeserializované JSON má jiné bajty.
Vložte produkční adresu do nastavení
V Nastavení → API a MCP v části Webhooky přidáte koncový bod a zaškrtnete události, které chcete dostávat.
Ověřte podpis a dotáhněte data
Za Webhook dejte uzel Code s ověřovacím kódem z administrace, data pak čtěte uzlem HTTP Request s klíčem v hlavičce.
03Meze
Co to neumí
Tohle je ta část, kterou většina stránek o integracích vynechá. Radši to víte předem.
Počítejte s tím
- Neobsahuje: Adresa musí být veřejná a přes https: n8n běžící jen ve vaší síti se k nám nedostane
- Neobsahuje: Bez zapnutého Raw Body v uzlu Webhook podpis nikdy nebude sedět
- Neobsahuje: Doručujeme nejméně jednou, takže tutéž zprávu můžete dostat víckrát. Deduplikujte podle jejího identifikátoru
- Neobsahuje: Pokusů o doručení je nejvýš 6 a pak zprávu vzdáme. Adresa, která selhává opakovaně, se sama pozastaví
- Neobsahuje: Webhooky běží jen se zapnutým REST API, které zapíná vlastník obchodu v Nastavení → API a MCP, jen s placeným tarifem, nebo s jeho zkušebním obdobím a uloženou kartou
- Neobsahuje: Přes REST API se dá jen číst: objednávky, vratky a zásilky, produkty a kategorie, zásoby a skladové pohyby, zákazníci a doklady s PDF a ISDOC. Zápis zvenčí API nemá
Časté dotazy
Na co se ptáte
Funguje to i s n8n, které si hostuju sám?
Ano, pokud je jeho produkční adresa dostupná z internetu přes https. Instance běžící jen ve vnitřní síti se k nám nedostane, protože na neveřejné adresy záměrně neposíláme nic.
Proč mi neprochází ověření podpisu?
V devíti z deseti případů kvůli vypnutému Raw Body v uzlu Webhook. Podepisujeme přesně ty bajty, které odesíláme, takže tělo, které si n8n samo přeskládá, dá jiný otisk.
Potřebuju k tomu placený tarif n8n?
Ne, z naší strany na tom nezáleží. Uzly Webhook, Code i HTTP Request jsou běžná výbava n8n. Kolik API klíčů si u nás můžete vytvořit, určuje váš tarif SHOPZI, viz ceník.
Napojení je v ceně od tarifu Basic
Začít můžete zdarma. Napojení zapnete s tarifem Basic nebo vyšším, který vyzkoušíte 30 dní zdarma, a za samotné napojení nic navíc neplatíte. SHOPZI si z vašich prodejů nebere nic.