Vytváranie rozhraní webhook

Rozhrania webhook sú nástrojom na získavanie a ukladanie údajov z určitej udalosti. Umožňujú vám zaregistrovať adresu URL s protokolom https://, kde sa môžu ukladať údaje o udalosti vo formátoch JSON alebo XML. Rozhrania webhook sa zvyčajne používajú z nasledujúcich dôvodov:

Zadanie objednávky
Zmena ceny produktu
Upozornenie klienta okamžitých správ (IM) alebo pagera, keď ste offline
Zhromažďovanie údajov pre dátové sklady
Integrácia vášho účtovného softvéru
Filtrovanie položiek objednávky a informovanie rôznych prepravcov o objednávke
Odstránenie údajov o zákazníkoch z vašej databázy, keď odinštalujú vašu aplikáciu

Na tejto stránke

Podporované udalosti rozhrania webhook

Pri vytváraní rozhrania webhook si môžete vybrať z ktorejkoľvek z uvedených udalostí. Ak napríklad chcete vytvoriť rozhranie webhook, ktoré sa odošle zakaždým, keď je objednávka zaplatená, vyberte možnosť Platba objednávky. Ak chcete vytvoriť rozhranie webhook, ktoré sa odošle zakaždým, keď sa aktualizuje vlastnosť obchodu, vyberte možnosť Aktualizácia obchodu.

Tabuľka so zoznamom podporovaných udalostí rozhrania webhook dostupných v administrátorovi Shopify.
Kategória	Udalosti
Košík	Vytvorenie košíka Aktualizácia košíka
Pokladňa	Vytvorenie pokladne Odstránenie pokladne Aktualizácia pokladne
Kolekcia	Vytvorenie kolekcie Odstránenie kolekcie Aktualizácia kolekcie
Zákazník	Aktualizácia súhlasu zákazníka s SMS marketingom Aktualizácia nastavení zákazníckeho účtu Vytvorenie zákazníka Odstránenie zákazníka Vypnutie zákazníka Aktualizácia súhlasu zákazníka s e-mailovým marketingom Zapnutie zákazníka Vytvorenie skupiny zákazníkov Odstránenie skupiny zákazníkov Aktualizácia skupiny zákazníkov Pridané štítky zákazníka Odstránené štítky zákazníka Aktualizácia zákazníka
Zľava	Vytvorenie zľavy Odstránenie zľavy Aktualizácia zľavy
Návrh objednávky	Vytvorenie návrhu objednávky Odstránenie návrhu objednávky Aktualizácia návrhu objednávky
Naplnenie	Vytvorenie naplnenia Objednávku na vybavenie nemôže dokončiť služba plnenia objednávok Samostatné položky objednávky na vybavenie sú pripravené na vyzdvihnutie Objednávka na vybavenie presunutá Objednávka na vybavenie pozastavená Objednávka na vybavenie preplánovaná Naplánovaná objednávka na vybavenie je splatná Smerovanie objednávky na vybavenie bolo dokončené Objednávky na vybavenie zrušené Žiadosť o zrušenie objednávok na vybavenie prijatá Žiadosť o zrušenie objednávok na vybavenie zamietnutá Žiadosť o zrušenie objednávok na vybavenie odoslaná Žiadosť o vybavenie objednávok na vybavenie prijatá Žiadosť o vybavenie objednávok na vybavenie zamietnutá Žiadosť o vybavenie objednávok na vybavenie odoslaná Pozastavenie objednávok na vybavenie zrušené Samostatné položky objednávok na vybavenie pripravené na miestne doručenie Objednávky na vybavenie zlúčené Objednávky na vybavenie rozdelené Aktualizácia naplnenia
Inventár	Vytvorenie položky zásob Odstránenie položky zásob Aktualizácia položky zásob Pripojenie úrovne zásob Odpojenie úrovne zásob Aktualizácia úrovne zásob
Lokalita	Aktivácia lokality Vytvorenie lokality Deaktivácia lokality Odstránenie lokality Aktualizácia položky lokality
Trh	Vytvorenie trhu Odstránenie trhu Aktualizácia trhu
Objednávka	Zrušenie objednávky Vytvorenie objednávky Odstránenie objednávky Úprava objednávky Naplnenie objednávky Platba objednávky Zmena posúdenia rizika objednávky Aktualizácia objednávky
Produkt	Vytvorenie produktu Odstránenie produktu Aktualizácia produktu
Vrátenie peňazí	Vytvorenie vrátenia peňazí
Obchod	Aktualizácia obchodu
Platobný prostriedok	Vytvorenie platobnej transakcie
Téma	Vytvorenie témy Odstránenie témy Publikovanie témy Aktualizácia témy
Transakcia	Vytvorenie transakcie

Vytvorenie webhookov

Webhook môžete vytvoriť kedykoľvek. Vaše webhooky sú podpísané pomocou ID, ktoré sa skladá z kombinácie písmen a čísel, a ktoré je jedinečné pre váš obchod.

Kroky:

Počítač

V administrátorovi Shopify prejdite na Nastavenia > Oznámenia.
Kliknite na Webhooky.
Kliknite na ⊕ Vytvoriť webhook.
V rozbaľovacej ponuke Udalosť vyberte z podporovaných udalostí webhookov tú, ktorú chcete použiť pre svoj webhook. Po vytvorení webhooku už udalosť nemôžete zmeniť.
V rozbaľovacej ponuke Formát vyberte formát, v ktorom vám má Shopify odosielať tieto informácie. Na výber máte JSON alebo XML.
Do poľa URL zadajte URL, kde sa majú ukladať dáta. Webhooky nie je možné vrátiť na nasledujúce URL adresy:
- Localhost
- Akékoľvek URL končiace na slovo „internal“ (napríklad example.com/internal)
- Akákoľvek URL z akejkoľvek vlastnej domény priradenej k obchodu
- „Falošné“ domény (napríklad www.example.com)
- Domény Shopify (napríklad shopify.com a myshopify.com)
V poli Verzia API webhooku vyberte preferovanú verziu webhooku.
Kliknite na Uložiť.

Mobil

V aplikácii Shopify ťuknite na a potom na Nastavenia.
V sekcii Nastavenia obchodu ťuknite na Oznámenia.
Ťuknite na Webhooky.
Ťuknite na ⊕ Vytvoriť webhook.
V rozbaľovacej ponuke Udalosť vyberte z podporovaných udalostí webhookov tú, ktorú chcete použiť pre svoj webhook. Po vytvorení webhooku už udalosť nemôžete zmeniť.
V rozbaľovacej ponuke Formát vyberte formát, v ktorom vám má Shopify odosielať tieto informácie. Na výber máte JSON alebo XML.
Do poľa URL zadajte URL, kde sa majú ukladať dáta. Webhooky nie je možné vrátiť na nasledujúce URL adresy:
- Localhost
- Akékoľvek URL končiace na slovo „internal“ (napríklad example.com/internal)
- Akákoľvek URL z akejkoľvek vlastnej domény priradenej k obchodu
- „Falošné“ domény (napríklad www.example.com)
- Domény Shopify (napríklad shopify.com a myshopify.com)
V poli Verzia API webhooku vyberte preferovanú verziu webhooku.
Ťuknite na Uložiť alebo na ✓.

Keď sa nový webhook uloží, zobrazí sa na stránke Webhooky.

Úprava webhookov

Konfiguráciu webhooku môžete upraviť aj po jeho vytvorení. Nemôžete však zmeniť vybranú udalosť webhooku.

Kroky:

Počítač

V administrátorovi Shopify prejdite na Nastavenia > Oznámenia.
Kliknite na Webhooky.
V riadku s webhookom, ktorý chcete upraviť, kliknite na ... > Upraviť.
V dialógovom okne Upraviť webhook upravte webhook podľa potreby.
Kliknite na Uložiť.

Mobil

V aplikácii Shopify ťuknite na a potom na Nastavenia.
V sekcii Nastavenia obchodu ťuknite na Oznámenia.
Ťuknite na Webhooky.
V riadku s webhookom, ktorý chcete upraviť, ťuknite na ... > Upraviť.
V dialógovom okne Upraviť webhook upravte webhook podľa potreby.
Ťuknite na Uložiť alebo na ✓.

Testovanie webhookov

Svoj webhook môžete otestovať, aby ste sa uistili, že informácie o udalosti sa odosielajú na správnu URL.

Kroky:

Počítač

V administrátorovi Shopify prejdite na Nastavenia > Oznámenia.
Kliknite na Webhooky.
V riadku s webhookom, ktorý chcete otestovať, kliknite na ... > Odoslať test.
Na URL adrese zadanej pre daný webhook overte, či oznámenie funguje.

Mobil

V aplikácii Shopify ťuknite na a potom na Nastavenia.
V sekcii Nastavenia obchodu ťuknite na Oznámenia.
Ťuknite na Webhooky.
V riadku s webhookom, ktorý chcete otestovať, ťuknite na ... > Odoslať test.
Na URL adrese zadanej pre daný webhook overte, či oznámenie funguje.

Odstránenie webhookov

Webhook môžete odstrániť v administrátorovi Shopify. Túto akciu nemožno vrátiť späť.

Kroky:

Počítač

V administrátorovi Shopify prejdite na Nastavenia > Oznámenia.
Kliknite na Webhooky.
V riadku s webhookom, ktorý chcete odstrániť, kliknite na ... > Odstrániť.

Mobil

V aplikácii Shopify ťuknite na a potom na Nastavenia.
V sekcii Nastavenia obchodu ťuknite na Oznámenia.
Ťuknite na Webhooky.
V riadku s webhookom, ktorý chcete odstrániť, ťuknite na ... > Odstrániť.