Co dělá webhook
Webhook pošle údaje o události ve vašem obchodě jinam ve chvíli, kdy nastane. Vy zvolíte událost a kam se má poslat:
- API: Storeep pošle data události na webovou adresu (URL) vašeho serveru, CRM, scénáře Zapier nebo Make nebo nástroje pro sledování reklam.
- E-mail: Storeep pošle data události na e-mailovou adresu, například abyste dostali e-mail ke každé nové objednávce.
Otevřete Nastavení > Webhooky. Potřebujete oprávnění Nastavení.
Pro mnoho nástrojů už existuje hotová aplikace, což je jednodušší: Google Sheets, kurýrní sítě a reklamní pixely. Nejdřív se podívejte do tržiště aplikací.
Vytvoření webhooku
Klikněte na Přidat nový webhook, vyplňte formulář a klikněte na Přidat.
- Aktivovat: ve výchozím stavu zaškrtnuté. Když je zaškrtnuté, události se odesílají okamžitě. Odškrtnutím webhook ponecháte, ale pozastavíte.
- Jméno: označení pro váš seznam, například "CRM nové objednávky".
- Typ: API nebo E-mail.
- Událost:
- Objednávka byla vytvořena: zákazník odešle novou objednávku.
- Objednávka aktualizována: změní se stav nebo údaje objednávky.
- Vytvořená relace: do obchodu přijde nový návštěvník. Jen pro typ API.
- Formát: Json.
- URL (typ API): adresa, kam se má posílat. Část
https://se doplní za vás, napište tedy zbytek, napříkladapi.example.com/orders. - E-mailová adresa (typ E-mail): kam má e-mail přijít.
Webhook typu E-mail posílá jen události objednávek. Pokud zvolíte E-mail s událostí Vytvořená relace, nic se neodešle.
Vložení dat objednávky do URL
Do URL můžete vložit libovolné pole z dat události pomocí dvojitých složených závorek, {{field_name}}. Například:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Tím pošlete ID kliknutí z Facebooku a celkovou částku objednávky do platformy pro sledování reklam nebo affiliate platformy, bez dalšího serveru. Pole, které neexistuje, zůstane prázdné. Názvy polí zjistíte tak, že vytvoříte webhook typu E-mail pro stejnou událost a podíváte se na data, která dostanete.
Seznam webhooků
Každý řádek ukazuje Jméno, URL / E-mail, Typ, Událost, Formát a Stav (Aktivováno nebo Deaktivováno). Kliknutím na řádek ho upravíte. Zaškrtněte řádky a zvolte Smazat webhooky, abyste je trvale odstranili. Počet webhooků na obchod je omezený a po dosažení limitu uvidíte zprávu.
Pro stejnou událost můžete vytvořit více webhooků, například jeden do CRM a jeden do nástroje pro sledování reklam.
Když doručení selže
- Váš server by měl rychle odpovědět kódem úspěchu (2xx). Pomalá odpověď se počítá jako selhání.
- Pokud je váš server nedostupný nebo přetížený (odpověď 5xx nebo 429, nebo žádná odpověď), Storeep to během několika dalších minut několikrát zkusí znovu. Opakují se jen webhooky, které selhaly, takže ostatní nedostanou duplicity.
- Pokud váš server požadavek odmítne (odpověď 4xx, například 404 nebo 403), Storeep to znovu nezkouší, protože je chybná adresa nebo její zabezpečení.
- Když webhook selže několikrát za sebou, majitel obchodu dostane jeden e-mail: "Vyžadována akce: váš webhook Storeep selhává", s názvem webhooku, adresou, událostí a posledním chybovým kódem. Jakmile webhook zase funguje, další problém může poslat nové varování. Tento e-mail můžete vypnout v Oznámeních.
- Webhooky typu E-mail se posílají jednou, bez opakování.
Webhooky pozastavené kvůli nezaplacenému zůstatku
Pokud má váš obchod nezaplacenou dlužnou částku a peněženka ji nepokryje, webhooky čekají. Odešlou se, až přidáte prostředky a částka se vyrovná. Viz Peněženka a fakturace.
Tipy
- Pokud váš server potřebuje heslo nebo klíč, vložte ho do parametrů URL, například
?key=yoursecret. - Vytvořená relace se spouští u každého návštěvníka, což může být u rušného obchodu hodně. Používejte ji jen tehdy, když to váš server zvládne.
- Pokud má nástroj číst vaše objednávky a produkty, kdykoli potřebuje, použijte místo toho přístupový token.