Webhooken luominen

Webhookit ovat työkalu tietyn tapahtuman tietojen noutamiseen ja tallentamiseen. Niiden avulla voit rekisteröidä https://-URL-osoitteen, johon tapahtumatiedot voidaan tallentaa JSON- tai XML-muodossa. Webhookien yleisiä käyttötarkoituksia ovat seuraavat:

• Tilauksen tekeminen
• Tuotteen hinnan muuttaminen
• Ilmoittaminen asiasta, kun pikaviestiohjelmasi tai hakulaitteesi on offline-tilassa
• Tietojen kerääminen tietojen varastointia varten
• Kirjanpito-ohjelmiston integrointi
• Tilauskohteiden suodattaminen ja eri lähettäjille tiedottaminen tilauksesta
• Asiakastietojen poistaminen tietokannasta, kun he poistavat sovelluksesi

Huomaa

Saat sähköpostia kaupan omistajan sähköpostiosoitteeseen, kun webhook epäonnistuu. Sähköposti lähetetään vain, kun webhook on luotu Shopify App Storesta hankitulla sovelluksella tai mukautetulla sovelluksella. Jos webhook-kohde palaa toistuvasti tilavastaukseen, joka ei ole 200, webhook-tilaus poistetaan automaattisesti Shopify Administa.

Tuetut webhook-tapahtumat

Kun luot webhookin, voit valita minkä tahansa listatuista tapahtumista. Jos esimerkiksi haluat luoda webhookin, joka lähetetään joka kerta, kun tilaus on maksettu, valitse Tilauksen maksu. Jos esimerkiksi haluat luoda webhookin, joka lähetetään joka kerta, kun kaupan ominaisuutta päivitetään, valitse Kaupan päivitys.

Taulukko, jossa luetellaan Shopify Adminissa käytettävissä olevat tuetut webhook-tapahtumat.

Luokka	Tapahtumat
Ostoskori	Ostoskorin luominen Ostoskorin päivitys
Kassa	Kassavaiheen luominen Kassavaiheen poistaminen Kassavaiheen päivittäminen
Kokoelma	Kokoelman luominen Kokoelman poistaminen Kokoelman päivittäminen
Asiakas	Asiakkaan suostumuksen päivittäminen SMS-markkinointia varten Asiakastilin asetusten päivitys Asiakkaan luominen Asiakkaan poistaminen Asiakkaan poistaminen käytöstä Asiakkaan suostumuksen päivittäminen sähköpostimarkkinointia varten Asiakkaan ottaminen käyttöön Asiakasryhmien luominen Asiakasryhmän poistaminen Asiakasryhmän päivitys Asiakastunnisteita lisätty Asiakastunnisteet poistettu Asiakkaan päivitys
Alennus	Alennuksen luonti Alennuksen poisto Alennuksen päivitys
Tilausluonnos	Tilausluonnoksen luominen Tilausluonnoksen poistaminen Tilausluonnoksen päivitys
Jakelu	Jakelun luominen Tilausten täyttämisen palvelu ei voi viimeistellä täyttämistilausta Jakelutilauksen rivikohtia valmistellaan noudettaviksi Jakelutilaus siirretty Täytettävä tilaus asetettu pitoon Jakelutilaus ajoitettu uudelleen Ajoitettu täytettävä tilaus erääntyy Täytettävän tilauksen tilausreititys 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 jakelupyyntö hyväksytty Täytettävien tilausten täyttämispyyntö hylätty Täytettävien tilausten jakelupyyntö lähetetty Täytettävien tilausten pito vapautettu Paikalliseen toimitukseen valmistellut täytettävien tilausten rivikohdat Täytettävät tilaukset yhdistetty Täytettävät tilaukset ositettu Jakelupäivitys
Varasto	Varastokohteen luominen Varastokohteen poistaminen Varastokohteen päivitys Yhteyden muodostaminen varastotasoon Varastotasoyhteyden katkaisu Varastokohteen päivitys
Toimipaikka	Sijainnin ottaminen käyttöön Sijainnin luominen Sijainnin poistaminen käytöstä Sijainnin poistaminen Sijainnin tuotteen päivitys
Markkinat	Markkina-alueen luominen Markkina-alueen poistaminen Markkina-alueen päivitys
Tilaus	Tilauksen peruuttaminen Tilauksen luominen Tilauksen poistaminen Tilauksen muokkaus Tilauksen jakelu Tilauksen maksu Tilauksen riskiarviointia muutettu Tilauksen päivitys
Tuote	Tuotteen luominen Tuotteen poistaminen Tuotteen päivitys
Maksun palautus	Maksun palautuksen luominen
Shop	Kaupan päivitys
Tarjouspyyntö	Tarjouksen maksutapahtuman luominen
Teema	Teeman luominen Teeman poistaminen Teeman julkaiseminen Teeman päivitys
Tapahtuma	Tapahtuman luominen

Vinkki

Kehittäjät voivat käyttää webhook-aiheiden täydellistä luetteloa apuna toistuvia webhook-tilauksia luotaessa.

Luo webhookeja

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

Vaiheet:

Tietokone

1. Siirry Shopify Administasi kohtaan Asetukset >Ilmoitukset.

2. Klikkaa Webhookit.

3. Klikkaa ⊕ Luo webhook.

4. Valitse Tapahtuma-pudotusvalikosta jokin tuetuista webhook-tapahtumista, joita haluat käyttää webhook-tapahtumana. Et voi muuttaa webhook-tapahtumaa webhookin luomisen jälkeen.

5. Valitse Muotoile-pudotusvalikosta muoto, jossa haluat Shopifyn lähettävän nämä tiedot sinulle. Kaksi vaihtoehtoa ovat JSON tai XML.

6. Kirjoita URL-kenttään URL-osoite, johon haluat tallentaa tiedot. Webhookeja ei voida palauttaa seuraaviin URL-osoitteisiin:

   • Localhost
   • Mikä tahansa URL-osoite, joka päättyy sanalla "internal" (esim. example.com/internal)
   • Mikä tahansa kauppaan liitetty mukautetun verkkotunnuksen URL-osoite
   • "Ei-todelliset" verkkotunnukset (esim. www.example.com)
   • Shopify-verkkotunnukset (esim. shopify.com ja myshopify.com)

7. Valitse Webhook API ‑versiosta haluamasi webhook-versio.

8. Klikkaa Tallenna.

iPhone

1. Napauta Shopify-sovelluksessa …-painiketta ja napauta sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ⊕ Luo webhook.
5. Valitse Tapahtuma-pudotusvalikosta jokin tuetuista webhook-tapahtumista, joita haluat käyttää webhook-tapahtumana. Et voi muuttaa webhook-tapahtumaa webhookin luomisen jälkeen.
6. Valitse Muotoile-pudotusvalikosta muoto, jossa haluat Shopifyn lähettävän nämä tiedot sinulle. Kaksi vaihtoehtoa ovat JSON tai XML.

7. Kirjoita URL-kenttään URL-osoite, johon haluat tallentaa tiedot. Webhookeja ei voida palauttaa seuraaviin URL-osoitteisiin:

   • Localhost
   • Mikä tahansa URL-osoite, joka päättyy sanalla "internal" (esim. example.com/internal)
   • Mikä tahansa kauppaan liitetty mukautetun verkkotunnuksen URL-osoite
   • "Ei-todelliset" verkkotunnukset (esim. www.example.com)
   • Shopify-verkkotunnukset (esim. shopify.com ja myshopify.com)

8. Valitse Webhook API ‑versiosta haluamasi webhook-versio.

9. Napauta Tallenna.

Android

1. Napauta Shopify-sovelluksessa ☰ ja sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ⊕ Luo webhook.
5. Valitse Tapahtuma-pudotusvalikosta jokin tuetuista webhook-tapahtumista, joita haluat käyttää webhook-tapahtumana. Et voi muuttaa webhook-tapahtumaa webhookin luomisen jälkeen.
6. Valitse Muotoile-pudotusvalikosta muoto, jossa haluat Shopifyn lähettävän nämä tiedot sinulle. Kaksi vaihtoehtoa ovat JSON tai XML.

7. Kirjoita URL-kenttään URL-osoite, johon haluat tallentaa tiedot. Webhookeja ei voida palauttaa seuraaviin URL-osoitteisiin:

   • Localhost
   • Mikä tahansa URL-osoite, joka päättyy sanalla "internal" (esim. example.com/internal)
   • Mikä tahansa kauppaan liitetty mukautetun verkkotunnuksen URL-osoite
   • "Ei-todelliset" verkkotunnukset (esim. www.example.com)
   • Shopify-verkkotunnukset (esim. shopify.com ja myshopify.com)

8. Valitse Webhook API ‑versiosta haluamasi webhook-versio.

9. Napauta ✓.

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

Muokkaa webhookia

Voit muokata webhookin määritystä sen jälkeen, kun se on luotu. Et voi kuitenkaan muokata valittua webhook-tapahtumaa.

Vaiheet:

Tietokone

1. Siirry Shopify Administasi kohtaan Asetukset >Ilmoitukset.

2. Klikkaa Webhookit.

3. Klikkaa muokattavan webhookin sisältävältä riviltä ... > Muokkaa.

4. Muokkaa webhookia tarpeen mukaan Muokkaa webhookia ‑valintaikkunassa.

5. Klikkaa Tallenna.

iPhone

1. Napauta Shopify-sovelluksessa …-painiketta ja napauta sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta muokattavan webhookin sisältävältä riviltä ... > Muokkaa.
5. Muokkaa webhookia tarpeen mukaan Muokkaa webhookia ‑valintaikkunassa.
6. Napauta Tallenna.

Android

1. Napauta Shopify-sovelluksessa ☰ ja sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta muokattavan webhookin sisältävältä riviltä ... > Muokkaa.
5. Muokkaa webhookia tarpeen mukaan Muokkaa webhookia ‑valintaikkunassa.
6. Napauta ✓.

Webhookien testaaminen

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

Vaiheet:

Tietokone

1. Siirry Shopify Administasi kohtaan Asetukset >Ilmoitukset.

2. Klikkaa Webhookit.

3. Klikkaa ... > Lähetä testi testattavan webhookin sisältävällä rivillä.

4. Varmista webhookille määrittämästäsi URL-osoitteesta, että ilmoitus toimii.

iPhone

1. Napauta Shopify-sovelluksessa …-painiketta ja napauta sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ... > Lähetä testi testattavan webhookin sisältävällä rivillä.
5. Varmista webhookille määrittämästäsi URL-osoitteesta, että ilmoitus toimii.

Android

1. Napauta Shopify-sovelluksessa ☰ ja sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ... > Lähetä testi testattavan webhookin sisältävällä rivillä.
5. Varmista webhookille määrittämästäsi URL-osoitteesta, että ilmoitus toimii.

Poista webhookit

Voit poistaa webhookin Shopify Administa. Tätä toimintoa ei voi peruuttaa.

Huomaa

Jos webhook-kohde palaa toistuvasti tilavastaukseen, joka ei ole 200, webhook-tilaus poistetaan automaattisesti Shopify Administa.

Vaiheet:

Tietokone

1. Siirry Shopify Administasi kohtaan Asetukset >Ilmoitukset.

2. Klikkaa Webhookit.

3. Klikkaa ... > Poista poistettavan webhookin sisältävältä riviltä.

iPhone

1. Napauta Shopify-sovelluksessa …-painiketta ja napauta sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ... > Poista poistettavan webhookin sisältävällä rivillä.

Android

1. Napauta Shopify-sovelluksessa ☰ ja sen jälkeen Asetukset.
2. Napauta Kaupan asetukset -osiossa Sijainnit.
3. Napauta Webhookit.
4. Napauta ... > Poista poistettavan webhookin sisältävällä rivillä.