Čo robia webhooky
Webhook je predplatné konkrétnej udalosti obchodu. Keď táto udalosť nastane, Storeep okamžite odošle dáta udalosti na URL, ktorú zadáte (typ API), alebo na e-mailovú adresu, ktorú zadáte (typ E-mail). Webhooky sa bežne používajú pre integrácie sledovania objednávok, synchronizácie CRM, konverzie reklamných platforiem a automatické notifikácie.
Na správu webhookov prejdite do Nastavenia → Webhooky.
Limity webhookov
- Maximum 20 webhookov na obchod. Pokus o pridanie 21. vráti chybu.
- Webhooky sú zoradené od najnovšieho, stránkované po 40.
Vytvorenie webhooku
Kliknite na Pridať nový webhook.
Prepínač aktivácie
Keď je zaškrtnutý (predvolené), webhook je aktívny od momentu uloženia. Udalosti sa odosielajú okamžite. Odškrtnite, ak chcete uložiť webhook v deaktivovanom stave bez prijímania udalostí. Webhook môžete kedykoľvek aktivovať alebo deaktivovať jeho úpravou.
Názov
- Povinné.
- Maximum 50 znakov.
- Popisné označenie zobrazené v zozname webhookov. Príklad: Facebook CAPI, objednávka vytvorená.
Typ
Riadi spôsob doručenia obsahu udalosti. Dve možnosti:
- API: Storeep odošle HTTP POST požiadavku s dátami udalosti na URL, ktorú zadáte.
- E-mail: Storeep odošle e-mail s dátami udalosti na adresu, ktorú zadáte.
Udalosť
Udalosť obchodu, ktorá spúšťa tento webhook. K dispozícii sú tri udalosti:
- Relácia vytvorená: spustí sa, keď sa vo vašom obchode vytvorí nová relácia návštevníka.
- Objednávka vytvorená: spustí sa, keď je zadaná nová objednávka.
- Objednávka aktualizovaná: spustí sa, keď sa zmení stav alebo dáta existujúcej objednávky.
Formát
Formát dát obsahu udalosti. Aktuálne jedna možnosť:
- Json: obsah sa odošle ako JSON dokument.
URL (iba typ API)
- Povinné, keď je typ API.
- Maximum 500 znakov. Vyšší limit pokrýva URL obsahujúce viacero zástupných segmentov.
- Zadajte URL endpointu bez predpony
https://. Pridá sa automaticky. Príklad:api.example.com/events/order. - Dynamické zástupné znaky URL: akékoľvek pole z obsahu udalosti možno vložiť do URL pomocou syntaxe s dvojitými zátvorkmi:
{{field_name}}. Napríklad:https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
To vám umožňuje posielať konverzné dáta na reklamné platformy priamo z URL webhooku bez samostatného proxy servera. - Ak je štruktúra URL po nahradení zástupných znakov neplatná, dostanete chybu overenia.
E-mailová adresa (iba typ E-mail)
- Povinné, keď je typ E-mail.
- Musí byť platná e-mailová adresa, maximum 127 znakov.
Úprava webhooku
Kliknite na ľubovoľný riadok webhooku a otvorte editor. Všetky polia sú editovateľné. Pole URL sa predvypĺňa iba ak je aktuálny typ API; pole e-mailu sa predvypĺňa iba ak je aktuálny typ E-mail. Prepnutie typu vymaže druhé pole.
Aktivácia a deaktivácia webhookov
Zaškrtávacie políčko Aktivovať v hornej časti editora riadi, či webhook funguje. Stav v zozname zobrazuje Aktivovaný alebo Deaktivovaný. Deaktivovaný webhook nezaznamenáva žiadne doručenia, ale nie je vymazaný, takže ho môžete neskôr znova aktivovať bez opätovného nastavenia.
Stĺpce zoznamu webhookov
- Názov: označenie webhooku s dátumom vytvorenia.
- URL / E-mail: cieľová adresa.
- Typ: API alebo E-mail.
- Udalosť: názov udalosti (Relácia vytvorená, Objednávka vytvorená alebo Objednávka aktualizovaná).
- Formát: Json.
- Stav: Aktivovaný alebo Deaktivovaný.
Mazanie webhooku
Vyberte jeden alebo viac webhookov a kliknite na Vymazať webhooky. Toto je trvalé a zastaví všetky budúce doručenia pre dané predplatné.
Tipy a možné problémy
- Pre rovnakú udalosť môžete vytvoriť viacero webhookov, napríklad odosielať Objednávka vytvorená do CRM aj reklamnej platformy, každý ako samostatný záznam webhooku.
- Ak váš endpoint vyžaduje autentifikáciu, pridajte prihlasovacie údaje do query stringu URL pomocou
{{zástupného znaku}}zo dát udalosti, alebo nastavte proxy server, ktorý zvládne autentifikáciu pred presmerovaním na skutočný endpoint. - Udalosť Relácia vytvorená sa spustí pri každej jedinečnej relácii návštevníka, čo môže byť pri populárnych obchodoch vysoký objem. Prihláste sa na odber iba vtedy, ak váš endpoint zvládne takúto záťaž.