Webhookien luominen

Webhookit ovat työkalu, jolla voi hakea ja tallentaa tietoja tietystä tapahtumasta. Niiden avulla voit rekisteröidä https://-URL-osoitteen, johon tapahtumatiedot voidaan tallentaa JSON- tai XML-muodossa. Webhookeja käytetään yleisesti seuraaviin tarkoituksiin:

Tilauksen tekeminen
Tuotteen hinnan muuttaminen
Ilmoitusten saaminen pikaviestisovellukseen tai hakulaitteeseen, kun olet offline-tilassa
Tietojen kerääminen tietovarastointia varten
Kirjanpito-ohjelmiston integrointi
Tilaustuotteiden suodattaminen ja eri rahdinkuljettajille ilmoittaminen tilauksesta
Asiakastietojen poistaminen tietokannastasi, kun sovelluksesi asennus poistetaan

Tällä sivulla

Tuetut webhook-tapahtumat

Webhookia luodessasi voit valita minkä tahansa luetelluista tapahtumista. Jos esimerkiksi haluat luoda webhookin, joka lähetetään aina, kun tilaus on maksettu, valitse Tilauksen maksu. Jos taas haluat luoda webhookin, joka lähetetään aina, kun kaupan ominaisuutta päivitetään, valitse Kaupan päivitys.

Taulukko, jossa luetellaan Shopifyn ohjausnäkymässä käytettävissä olevat tuetut webhook-tapahtumat.
Kategoria	Tapahtumat
Ostoskori	Ostoskorin luominen Ostoskorin päivitys
Kassa	Kassan luominen Kassan poistaminen Kassan päivitys
Kokoelma	Kokoelman luominen Kokoelman poistaminen Kokoelman päivitys
Asiakas	Asiakkaan tekstiviestimarkkinointisuostumuksen päivitys Asiakastilin asetusten päivitys Asiakkaan luominen Asiakkaan poistaminen Asiakkaan käytöstä poistaminen Asiakkaan sähköpostimarkkinointisuostumuksen päivitys Asiakkaan käyttöönotto Asiakasryhmän luominen Asiakasryhmän poistaminen Asiakasryhmän päivitys Asiakastunnisteita lisätty Asiakastunnisteita poistettu Asiakkaan päivitys
Alennus	Alennuksen luominen Alennuksen poistaminen Alennuksen päivitys
Tilausluonnos	Tilausluonnoksen luominen Tilausluonnoksen poistaminen Tilausluonnoksen päivitys
Tilauksen täyttäminen	Tilauksen täyttämisen luominen Tilausten täyttämisen palvelu ei voi täyttää täytettävää tilausta Täytettävän tilauksen rivikohdat on valmisteltu noutoa varten Täytettävä tilaus siirretty Täytettävä tilaus asetettu pitoon Täytettävä tilaus ajastettu uudelleen Aiemmin ajastettu täytettävä tilaus on erääntynyt Täytettävän tilauksen reititys on valmis Täytettävät tilaukset peruutettu Täytettävien tilausten peruutuspyyntö hyväksytty Täytettävien tilausten peruutuspyyntö hylätty Täytettävien tilausten peruutuspyyntö lähetetty Täytettävien tilausten täyttöpyyntö hyväksytty Täytettävien tilausten täyttöpyyntö hylätty Täytettävien tilausten täyttöpyyntö lähetetty Täytettävien tilausten pito vapautettu Täytettävien tilausten rivikohdat valmisteltu paikallista toimitusta varten Täytettävät tilaukset yhdistetty Täytettävät tilaukset jaettu Tilauksen täyttämisen päivitys
Varasto	Varastokohteen luominen Varastokohteen poistaminen Varastokohteen päivitys Varastotason yhdistäminen Varastotason yhteyden katkaiseminen Varastotason päivitys
Sijainti	Sijainnin aktivointi Sijainnin luonti Sijainnin deaktivointi Sijainnin poistaminen Sijainnin tuotteen päivitys
Markkina-alue	Markkina-alueen luonti Markkina-alueen poistaminen Markkina-alueen päivitys
Tilaus	Tilauksen peruutus Tilauksen luonti Tilauksen poistaminen Tilauksen muokkaus Tilauksen täyttäminen Tilauksen maksu Tilauksen riskiarviointi muuttui Tilauksen päivitys
Tuote	Tuotteen luonti Tuotteen poistaminen Tuotteen päivitys
Maksun palautus	Maksunpalautuksen luonti
Shop	Shop-päivitys
Maksuväline	Maksuvälinetapahtuman luonti
Teema	Teeman luonti Teeman poistaminen Teeman julkaisu Teeman päivitys
Maksutapahtuma	Maksutapahtuman luonti

Webhookien luominen

Voit luoda webhookin milloin tahansa. Webhookisi allekirjoitetaan tunnuksella, joka koostuu kaupallesi yksilöllisestä kirjainten ja numeroiden yhdistelmästä.

Vaiheet:

Tietokone

Siirry Shopify-ohjausnäkymässäsi kohtaan Asetukset > Ilmoitukset.
Klikkaa Webhookit.
Klikkaa ⊕ Luo webhook.
Valitse Tapahtuma-pudotusvalikosta jokin tuetuista webhook-tapahtumista, jota haluat käyttää webhook-tapahtumanasi. Et voi muuttaa webhook-tapahtumaa webhookin luomisen jälkeen.
Valitse Muoto-pudotusvalikosta muoto, jossa haluat Shopifyn lähettävän nämä tiedot sinulle. Vaihtoehtoja on kaksi: JSON tai XML.
Syötä URL-kenttään URL-osoite, johon haluat tallentaa tiedot. Webhookeja ei voi palauttaa seuraaviin URL-osoitteisiin:
- Localhost
- Mihin tahansa URL-osoitteeseen, joka päättyy sanaan ”internal” (kuten example.com/internal)
- Minkä tahansa kauppaan liitetyn mukautetun verkkotunnuksen URL-osoitteeseen
- ”Vale”-verkkotunnuksiin (kuten www.example.com)
- Shopify-verkkotunnuksiin (kuten shopify.com ja myshopify.com)
Valitse Webhook API -versio -kentästä haluamasi webhook-versio.
Klikkaa Tallenna.

Mobiili

Napauta Shopify-sovelluksessa ja napauta sitten Asetukset.
Napauta Kaupan asetukset -osiossa Ilmoitukset.
Napauta Webhookit.
Napauta ⊕ Luo webhook.
Valitse Tapahtuma-pudotusvalikosta jokin tuetuista webhook-tapahtumista, jota haluat käyttää webhook-tapahtumanasi. Et voi muuttaa webhook-tapahtumaa webhookin luomisen jälkeen.
Valitse Muoto-pudotusvalikosta muoto, jossa haluat Shopifyn lähettävän nämä tiedot sinulle. Vaihtoehtoja on kaksi: JSON tai XML.
Syötä URL-kenttään URL-osoite, johon haluat tallentaa tiedot. Webhookeja ei voi palauttaa seuraaviin URL-osoitteisiin:
- Localhost
- Mihin tahansa URL-osoitteeseen, joka päättyy sanaan ”internal” (kuten example.com/internal)
- Minkä tahansa kauppaan liitetyn mukautetun verkkotunnuksen URL-osoitteeseen
- ”Vale”-verkkotunnuksiin (kuten www.example.com)
- Shopify-verkkotunnuksiin (kuten shopify.com ja myshopify.com)
Valitse Webhook API -versio -kentästä haluamasi webhook-versio.
Napauta Tallenna tai ✓.

Kun uusi webhookisi on tallennettu, se näkyy Webhookit-sivulla.

Webhookien muokkaaminen

Voit muokata webhookin määrityksiä sen luomisen jälkeen. Et kuitenkaan voi muokata valittua webhook-tapahtumaa.

Vaiheet:

Tietokone

Siirry Shopify-ohjausnäkymässäsi kohtaan Asetukset > Ilmoitukset.
Klikkaa Webhookit.
Klikkaa muokattavan webhookin rivillä ... > Muokkaa.
Muokkaa webhookia tarpeen mukaan Muokkaa webhookia -valintaikkunassa.
Klikkaa Tallenna.

Mobiili

Napauta Shopify-sovelluksessa ja napauta sitten Asetukset.
Napauta Kaupan asetukset -osiossa Ilmoitukset.
Napauta Webhookit.
Napauta muokattavan webhookin rivillä ... > Muokkaa.
Muokkaa webhookia tarpeen mukaan Muokkaa webhookia -valintaikkunassa.
Napauta Tallenna tai ✓.

Webhookien testaaminen

Voit testata webhookiasi varmistaaksesi, että haluamasi tapahtumatiedot lähetetään oikeaan URL-osoitteeseen.

Vaiheet:

Tietokone

Siirry Shopify-ohjausnäkymässäsi kohtaan Asetukset > Ilmoitukset.
Klikkaa Webhookit.
Klikkaa testattavan webhookin rivillä ... > Lähetä testi.
Varmista webhookille määrittämässäsi URL-osoitteessa, että ilmoitus toimii.

Mobiili

Napauta Shopify-sovelluksessa ja napauta sitten Asetukset.
Napauta Kaupan asetukset -osiossa Ilmoitukset.
Napauta Webhookit.
Napauta testattavan webhookin rivillä ... > Lähetä testi.
Varmista webhookille määrittämässäsi URL-osoitteessa, että ilmoitus toimii.

Webhookien poistaminen

Voit poistaa webhookin Shopify-ohjausnäkymästäsi. Toimintoa ei voi peruuttaa.

Vaiheet:

Tietokone

Siirry Shopify-ohjausnäkymässäsi kohtaan Asetukset > Ilmoitukset.
Klikkaa Webhookit.
Klikkaa poistettavan webhookin rivillä ... > Poista.

Mobiili

Napauta Shopify-sovelluksessa ja napauta sitten Asetukset.
Napauta Kaupan asetukset -osiossa Ilmoitukset.
Napauta Webhookit.
Napauta poistettavan webhookin rivillä ... > Poista.