Webhooks aanmaken

Webhooks zijn een tool voor het ophalen en opslaan van gegevens uit een bepaalde gebeurtenis. Hiermee kun je een https://-URL registreren waar de gebeurtenisgegevens kunnen worden opgeslagen in JSON- of XML-indeling. Webhooks worden vaak gebruikt om:

• een bestelling te plaatsen;
• de prijs van een product te wijzigen;
• je IM-client of pager te laten weten wanneer je offline bent;
• gegevens te verzamelen voor datawarehousing;
• je boekhoudsoftware te integreren;
• de bestelde artikelen te filteren en verschillende vervoerders te informeren over de bestelling;
• klantgegevens uit je database te verwijderen wanneer klanten je app verwijderen.

Opmerking

Je krijgt een e-mail op het e-mailadres van de winkeleigenaar wanneer een webhook niet lukt. De e-mail wordt alleen verzonden wanneer de webhook is aangemaakt via een app uit de Shopify App Store of door een gepersonaliseerde app. Als de webhook-bestemming herhaaldelijk een antwoord van niet-200 voor de status retourneert, wordt het webhookabonnement automatisch verwijderd uit het Shopify-beheercentrum.

Ondersteunde webhook-gebeurtenissen

Wanneer je een webhook maakt, kun je kiezen uit een van de vermelde gebeurtenissen. Als je bijvoorbeeld een webhook wil maken die elke keer wordt verzonden wanneer een bestelling is betaald, selecteer je Betaling van bestelling. Als je in een ander voorbeeld een webhook wil maken die elke keer wordt verzonden wanneer een winkeleigenschap wordt bijgewerkt, selecteer je Winkel bijwerken.

Tabel met de ondersteunde webhookgebeurtenissen die beschikbaar zijn in het Shopify-beheercentrum.

Categorie	Evenementen
Winkelwagen	Winkelwagen maken Winkelwagen bijwerken
Checkout	Aanmaak van checkout Verwijdering van checkout Update checkout
Collectie	Collectie maken Collectie verwijderen Collectie bijwerken
Klant	Toestemming van klant voor sms-marketing bijwerken Klantaccountinstellingen bijwerken Klant maken Klant verwijderen Klant uitschakelen Toestemming van klant voor e-mailmarketing bijwerken Klant inschakelen Klantgroep maken Klantgroep verwijderen Klantgroep bijwerken Klanttags toegevoegd Klanttags verwijderd Klant bijwerken
Korting	Korting maken Korting verwijderen Korting bijwerken
Conceptbestelling	Conceptbestelling maken Conceptbestelling verwijderen Conceptbestelling bijwerken
Afhandeling	Aanmaak van fulfilment Fulfilmentservice kan de fulfilmentbestelling niet voltooien Fulfilmentorderregels worden voorbereid op afhalen Fulfilmentbestelling verplaatst Fulfilmentbestelling gepauzeerd Fulfilmentbestelling opnieuw plannen Een geplande fulfilmentbestelling moet binnenkort worden betaald De route voor de fulfilmentbestelling is voltooid Fulfilmentbestellingen geannuleerd Aanvraag voor annulering van fulfilmentbestellingen geaccepteerd Aanvraag voor annulering van fulfilmentbestellingen afgewezen Aanvraag voor annulering van fulfilmentbestellingen ingediend Fulfilmentaanvraag fulfilmentbestelling geaccepteerd Fulfilmentaanvraag fulfilmentbestellingen afgewezen Fulfilmentaanvraag voor fulfilmentbestellingen ingediend Opschorting fulfilment-bestellingen vrijgegeven Fulfilmentorderregels voorbereid voor lokale bezorging Fulfilmentbestellingen samengevoegd Fulfilmentbestellingen opgesplitst Fulfilment bijgewerkt
Voorraad	Voorraadartikel maken Voorraadartikel verwijderen Voorraadartikel bijwerken Voorraadniveau verbinden Verbinding voorraadniveau verbreken Voorraadniveau bijwerken
Locatie	Locatie activeren Locatie maken Locatie deactiveren Locatie verwijderen Locatie-item bijwerken
Marketing	Markt maken Markt verwijderen Markt bijwerken
Bestelling	Bestelling annuleren Aanmaak van bestelling Bestelling verwijderen Bestelling bewerken Bestelling-fulfilment Bestelling betalen Risicobeoordeling bestelling wijzigen Bestelling bijwerken
Product	Product maken Product verwijderen Product bijwerken
Terugbetaling	Terugbetaling maken
Shop	Winkel bijwerken
Aanbesteding	Tender-transacties maken
Thema	Thema maken Thema verwijderen Thema publiceren Thema bijwerken
Transactie	Transactie maken

Tip

Ontwikkelaars kunnen de volledige lijst met webhookonderwerpen raadplegen wanneer ze webhookabonnementen maken.

Webhooks maken

Je kunt op elk gewenst moment een webhook maken. Je webhooks worden ondertekend met een ID bestaande uit een combinatie van letters en cijfers die uniek is voor je winkel.

Stappen:

Desktop

1. Ga in het Shopify-beheercentrum naar Instellingen > Meldingen.

2. Klik op Webhooks.

3. Klik op ⊕ Webhook maken.

4. Selecteer in de vervolgkeuzelijst Gebeurtenis een van de ondersteunde webhookgebeurtenissen die je wil gebruiken. Als de webhook eenmaal is gemaakt, kun je de webhookgebeurtenis niet meer wijzigen.

5. Kies in de vervolgkeuzelijst Indeling de indeling waarin je wil dat Shopify deze informatie naar je stuurt. Je kunt kiezen uit JSON of XML.

6. Voer in het veld URL de URL in waar je gegevens wil opslaan. Webhooks kunnen niet worden geretourneerd naar de volgende URL's:

   • Localhost
   • URL's eindigend op het woord 'internal' (bijvoorbeeld example.com/internal)
   • Elke URL van een aangepast domein dat is gekoppeld aan de winkel
   • Nepdomeinen (bijvoorbeeld www.example.com)
   • Shopify-domeinen (bijvoorbeeld shopify.com en myshopify.com)

7. Selecteer bij Webhook API-versie de gewenste webhookversie.

8. Klik op Opslaan.

iPhone

1. Tik in de Shopify-app op de knop … en daarna op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik op ⊕ Webhook maken.
5. Selecteer in de vervolgkeuzelijst Gebeurtenis een van de ondersteunde webhookgebeurtenissen die je wil gebruiken. Als de webhook eenmaal is gemaakt, kun je de webhookgebeurtenis niet meer wijzigen.
6. Kies in de vervolgkeuzelijst Indeling de indeling waarin je wil dat Shopify deze informatie naar je stuurt. Je kunt kiezen uit JSON of XML.

7. Voer in het veld URL de URL in waar je gegevens wil opslaan. Webhooks kunnen niet worden geretourneerd naar de volgende URL's:

   • Localhost
   • URL's eindigend op het woord 'internal' (bijvoorbeeld example.com/internal)
   • Elke URL van een aangepast domein dat is gekoppeld aan de winkel
   • Nepdomeinen (bijvoorbeeld www.example.com)
   • Shopify-domeinen (bijvoorbeeld shopify.com en myshopify.com)

8. Selecteer bij Webhook API-versie de gewenste webhookversie.

9. Tik op Opslaan.

Android

1. Tik in de Shopify-app op de knop ☰ en vervolgens op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik op ⊕ Webhook maken.
5. Selecteer in de vervolgkeuzelijst Gebeurtenis een van de ondersteunde webhookgebeurtenissen die je wil gebruiken. Als de webhook eenmaal is gemaakt, kun je de webhookgebeurtenis niet meer wijzigen.
6. Kies in de vervolgkeuzelijst Indeling de indeling waarin je wil dat Shopify deze informatie naar je stuurt. Je kunt kiezen uit JSON of XML.

7. Voer in het veld URL de URL in waar je gegevens wil opslaan. Webhooks kunnen niet worden geretourneerd naar de volgende URL's:

   • Localhost
   • URL's eindigend op het woord 'internal' (bijvoorbeeld example.com/internal)
   • Elke URL van een aangepast domein dat is gekoppeld aan de winkel
   • Nepdomeinen (bijvoorbeeld www.example.com)
   • Shopify-domeinen (bijvoorbeeld shopify.com en myshopify.com)

8. Selecteer bij Webhook API-versie de gewenste webhookversie.

9. Tik op ✓.

Nadat je nieuwe webhook is opgeslagen, wordt deze weergegeven op de pagina Webhooks.

Webhooks bewerken

Nadat je een webhook hebt gemaakt, kun je de configuratie bewerken. Maar je kunt de geselecteerde webhookgebeurtenis niet wijzigen.

Stappen:

Desktop

1. Ga in het Shopify-beheercentrum naar Instellingen > Meldingen.

2. Klik op Webhooks.

3. Klik in de rij met de webhook die je wil bewerken op ... > Bewerken.

4. Breng de gewenste wijzigingen aan in het dialoogvenster Webhook bewerken.

5. Klik op Opslaan.

iPhone

1. Tik in de Shopify-app op de knop … en daarna op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil bewerken op ... > Bewerken.
5. Breng de gewenste wijzigingen aan in het dialoogvenster Webhook bewerken.
6. Tik op Opslaan.

Android

1. Tik in de Shopify-app op de knop ☰ en vervolgens op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil bewerken op ... > Bewerken.
5. Breng de gewenste wijzigingen aan in het dialoogvenster Webhook bewerken.
6. Tik op ✓.

Webhooks testen

Je kunt je webhook testen om te controleren of de juiste gegevens naar de juiste URL worden verzonden.

Stappen:

Desktop

1. Ga in het Shopify-beheercentrum naar Instellingen > Meldingen.

2. Klik op Webhooks.

3. Klik in de rij met de webhook die je wil testen op ... > Test verzenden.

4. Controleer bij de URL die je voor de webhook hebt opgegeven of de melding werkt.

iPhone

1. Tik in de Shopify-app op de knop … en daarna op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil testen op ... > Test verzenden.
5. Controleer bij de URL die je voor de webhook hebt opgegeven of de melding werkt.

Android

1. Tik in de Shopify-app op de knop ☰ en vervolgens op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil testen op ... > Test verzenden.
5. Controleer bij de URL die je voor de webhook hebt opgegeven of de melding werkt.

Webhooks verwijderen

Je kunt een webhook uit het Shopify-beheercentrum verwijderen. Deze actie kan niet ongedaan worden gemaakt.

Opmerking

Als de webhook-bestemming herhaaldelijk een antwoord van niet-200 voor de status retourneert, wordt het webhookabonnement automatisch verwijderd uit het Shopify-beheercentrum.

Stappen:

Desktop

1. Ga in het Shopify-beheercentrum naar Instellingen > Meldingen.

2. Klik op Webhooks.

3. Klik in de rij met de webhook die je wil verwijderen op ... > Verwijderen.

iPhone

1. Tik in de Shopify-app op de knop … en daarna op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil verwijderen op ... > Verwijderen.

Android

1. Tik in de Shopify-app op de knop ☰ en vervolgens op Instellingen.
2. Tik in de sectie Winkelinstellingen op Meldingen.
3. Tik op Webhooks.
4. Tik in de rij met de webhook die je wil verwijderen op ... > Verwijderen.