Čo robí webhook
Webhook pošle podrobnosti o udalosti vo vašom obchode na iné miesto v momente, keď nastane. Vyberiete udalosť a kam sa má poslať:
- API: Storeep pošle údaje o udalosti na webovú adresu (URL) vášho servera, CRM, scenára v Zapier alebo Make, prípadne nástroja na sledovanie reklám.
- E-mail: Storeep pošle údaje o udalosti na e-mailovú adresu, napríklad aby ste dostali e-mail pri každej novej objednávke.
Otvorte Nastavenia > Webhooky. Potrebujete oprávnenie Nastavenia.
Mnohé nástroje už majú hotovú aplikáciu, čo je jednoduchšie: Google Sheets, kuriérske siete a reklamné pixely. Najprv si pozrite trh s aplikáciami.
Vytvorenie webhooku
Kliknite na Pridanie nového webhooku, vyplňte formulár a kliknite na Pridať.
- Aktivovať: predvolene označené. Keď je označené, udalosti sa posielajú okamžite. Zrušte označenie, ak chcete webhook ponechať, ale pozastaviť.
- Meno: označenie pre váš zoznam, napríklad „CRM nové objednávky“.
- Typ: API alebo E-mail.
- Udalosť:
- Objednávka vytvorená: zákazník vytvorí novú objednávku.
- Objednávka aktualizovaná: zmení sa stav alebo podrobnosti objednávky.
- Vytvorená relácia: do obchodu príde nový návštevník. Len pre typ API.
- Formát: Json.
- URL (typ API): adresa, kam sa má posielať. Časť
https://sa doplní za vás, takže napíšte zvyšok, napríkladapi.example.com/orders. - E-mailová adresa (typ E-mail): kam má e-mail prísť.
Webhook typu E-mail posiela len udalosti objednávok. Ak vyberiete E-mail s udalosťou Vytvorená relácia, nič sa neodošle.
Vloženie údajov objednávky do URL
Do URL môžete vložiť ľubovoľné pole z údajov udalosti pomocou dvojitých zložených zátvoriek, {{field_name}}. Napríklad:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Takto pošlete ID kliknutia z Facebooku a celkovú sumu objednávky do platformy na sledovanie reklám alebo affiliate platformy, bez ďalšieho servera. Pole, ktoré neexistuje, zostane prázdne. Názvy polí zistíte tak, že pre tú istú udalosť vytvoríte webhook typu E-mail a pozriete sa na údaje, ktoré dostanete.
Zoznam webhookov
Každý riadok zobrazuje Meno, URL / E-mail, Typ, Udalosť, Formát a Stav (Aktivované alebo Deaktivované). Kliknutím na riadok ho upravíte. Označte riadky a vyberte Odstrániť webhooky, ak ich chcete natrvalo odstrániť. Počet webhookov na obchod je obmedzený a keď dosiahnete maximum, zobrazí sa správa.
Pre tú istú udalosť môžete vytvoriť viac webhookov, napríklad jeden do CRM a jeden do reklamného trackera.
Keď doručenie zlyhá
- Váš server by mal rýchlo odpovedať kódom úspechu (2xx). Pomalá odpoveď sa počíta ako zlyhanie.
- Ak je server nedostupný alebo preťažený (odpoveď 5xx alebo 429, prípadne žiadna odpoveď), Storeep to v nasledujúcich minútach skúsi niekoľkokrát znova. Opakujú sa len webhooky, ktoré zlyhali, takže ostatné nedostanú duplikáty.
- Ak server požiadavku odmietne (odpoveď 4xx, napríklad 404 alebo 403), Storeep to neopakuje, pretože adresa alebo jej zabezpečenie je nesprávne.
- Keď webhook zlyhá niekoľkokrát za sebou, majiteľ obchodu dostane jeden e-mail: „Vyžaduje sa akcia: váš webhook Storeep zlyháva“, s názvom webhooku, adresou, udalosťou a posledným kódom chyby. Keď webhook znova funguje, ďalší problém môže poslať nové varovanie. Tento e-mail môžete vypnúť v Oznámeniach.
- Webhooky typu E-mail sa posielajú raz, bez opakovania.
Webhooky pozastavené pre nezaplatený zostatok
Ak má váš obchod nezaplatenú dlžnú sumu a peňaženka ju nepokryje, webhooky čakajú. Odošlú sa, keď pridáte finančné prostriedky a suma sa uhradí. Pozrite si článok Peňaženka a fakturácia.
Tipy
- Ak váš server potrebuje heslo alebo kľúč, vložte ho do parametrov URL, napríklad
?key=yoursecret. - Vytvorená relácia sa spúšťa pri každom návštevníkovi, čo môže byť v rušnom obchode veľa. Použite ju, len ak to váš server zvládne.
- Ak má nástroj čítať vaše objednávky a produkty kedykoľvek chce, použite namiesto toho prístupový token.