Webhooks aanmaken

Webhooks zijn een hulpmiddel voor het ophalen en opslaan van gegevens van een bepaalde gebeurtenis. Je kunt er een https://-URL mee registreren waar de gebeurtenisgegevens kunnen worden opgeslagen in JSON- of XML-indeling. Webhooks worden vaak om de volgende redenen gebruikt:

Een bestelling plaatsen
De prijs van een product wijzigen
Je IM-client of je pager een melding sturen wanneer je offline bent
Gegevens verzamelen voor datawarehousing
Je boekhoudsoftware integreren
De orderregels filteren en verschillende verzenders informeren over de bestelling
Klantgegevens uit je database verwijderen wanneer ze je app verwijderen

Op deze pagina

Ondersteunde webhookgebeurtenissen

Wanneer je een webhook aanmaakt, kun je kiezen uit een van de vermelde gebeurtenissen. Als je bijvoorbeeld een webhook wilt aanmaken die wordt verzonden telkens als een bestelling is betaald, selecteer je Order payment. Als je er een wilt die wordt verzonden telkens als een winkeleigenschap wordt bijgewerkt, selecteer je Shop update.

Tabel met de ondersteunde webhookgebeurtenissen die beschikbaar zijn in het Shopify-beheercentrum.
Categorie	Gebeurtenissen
Winkelwagen	Aanmaken van winkelwagen Updaten van winkelwagen
Checkout	Aanmaken van checkout Verwijderen van checkout Updaten van checkout
Collectie	Aanmaken van collectie Verwijderen van collectie Updaten van collectie
Klant	Update van toestemming van klant voor sms-marketing Update van instellingen van klantaccount Aanmaken van klant Verwijderen van klant Uitschakelen van klant Update van toestemming van klant voor e-mailmarketing Inschakelen van klant Aanmaken van klantengroep Verwijderen van klantengroep Updaten van klantengroep Klanttags toegevoegd Klanttags verwijderd Updaten van klant
Korting	Aanmaken van korting Verwijderen van korting Updaten van korting
Conceptbestelling	Aanmaken van conceptbestelling Verwijderen van conceptbestelling Updaten van conceptbestelling
Fulfilment	Aanmaken van fulfilment Fulfilmentbestelling kan niet worden voltooid door fulfilmentservice Orderregels van fulfilmentbestelling zijn voorbereid voor afhaalmoment Fulfilmentbestelling verplaatst Fulfilmentbestelling gepauzeerd Fulfilmentbestelling opnieuw ingepland Geplande fulfilmentbestelling vervalt Order-routing van fulfilmentbestelling voltooid Fulfilmentbestellingen geannuleerd Annuleringsaanvraag voor fulfilmentbestellingen geaccepteerd Annuleringsaanvraag voor fulfilmentbestellingen afgewezen Annuleringsaanvraag voor fulfilmentbestellingen ingediend Fulfilmentverzoek voor fulfilmentbestellingen geaccepteerd Fulfilmentverzoek voor fulfilmentbestellingen afgewezen Fulfilmentverzoek voor fulfilmentbestellingen ingediend Pauzering van fulfilmentbestellingen vrijgegeven Orderregels van fulfilmentbestellingen voorbereid voor lokale bezorging Fulfilmentbestellingen samengevoegd Fulfilmentbestellingen gesplitst Update van fulfilment
Voorraad	Aanmaken van voorraadartikel Verwijderen van voorraadartikel Update van voorraadartikel Koppeling van voorraadniveau Ontkoppeling van voorraadniveau Update van voorraadniveau
Locatie	Locatieactivering Locatieaanmaak Locatiedeactivering Locatieverwijdering Update van artikel op locatie
Markt	Marktaanmaak Marktverwijdering Marktupdate
Bestelling	Bestellingsannulering Bestellingsaanmaak Bestellingsverwijdering Bestellingsbewerking Bestellingsfulfilment Bestellingsbetaling Risicobeoordeling van bestelling gewijzigd Bestellingsupdate
Product	Productaanmaak Productverwijdering Productupdate
Terugbetaling	Terugbetalingsaanmaak
Shop	Shop-update
Aanbesteding	Aanmaak van aanbestedingstransactie
Thema	Thema-aanmaak Themaverwijdering Themapublicatie Thema-update
Transactie	Aanmaak van transactie

Webhooks aanmaken

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

Stappen:

Desktop

Ga in je Shopify-beheercentrum naar Instellingen > Meldingen.
Klik op Webhooks.
Klik op ⊕ Webhook aanmaken.
Selecteer in de vervolgkeuzelijst Gebeurtenis een van de ondersteunde webhook-gebeurtenissen die je wilt gebruiken als webhook-gebeurtenis. Je kunt de webhook-gebeurtenis niet meer wijzigen nadat de webhook is aangemaakt.
Kies in de vervolgkeuzelijst Indeling de indeling waarin je wilt dat Shopify deze informatie naar je verzendt. De twee keuzes zijn JSON of XML.
Voer in het veld URL de URL in waar je gegevens wilt opslaan. Webhooks kunnen niet worden verzonden naar de volgende URL's:
- Localhost
- Elke URL die eindigt op het woord ‘internal’ (zoals example.com/internal)
- Elke URL van een aangepast domein dat aan de winkel is gekoppeld
- ‘Nepdomeinen’ (zoals www.example.com)
- Shopify-domeinen (zoals shopify.com en myshopify.com)
Selecteer bij Webhook API-versie de gewenste webhook-API-versie.
Klik op Opslaan.

Mobiel

Tik in de Shopify-app op en tik vervolgens op Instellingen.
Tik in de sectie Winkelinstellingen op Meldingen.
Tik op Webhooks.
Tik op ⊕ Webhook aanmaken.
Selecteer in de vervolgkeuzelijst Gebeurtenis een van de ondersteunde webhook-gebeurtenissen die je wilt gebruiken als webhook-gebeurtenis. Je kunt de webhook-gebeurtenis niet meer wijzigen nadat de webhook is aangemaakt.
Kies in de vervolgkeuzelijst Indeling de indeling waarin je wilt dat Shopify deze informatie naar je verzendt. De twee keuzes zijn JSON of XML.
Voer in het veld URL de URL in waar je gegevens wilt opslaan. Webhooks kunnen niet worden verzonden naar de volgende URL's:
- Localhost
- Elke URL die eindigt op het woord ‘internal’ (zoals example.com/internal)
- Elke URL van een aangepast domein dat aan de winkel is gekoppeld
- ‘Nepdomeinen’ (zoals www.example.com)
- Shopify-domeinen (zoals shopify.com en myshopify.com)
Selecteer bij Webhook API-versie de gewenste webhook-API-versie.
Tik op Opslaan of ✓.

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

Webhooks bewerken

Je kunt de configuratie van een webhook bewerken nadat deze is aangemaakt. Je kunt de geselecteerde webhook-gebeurtenis echter niet wijzigen.

Stappen:

Desktop

Ga in je Shopify-beheercentrum naar Instellingen > Meldingen.
Klik op Webhooks.
Klik in de rij met de webhook die je wilt bewerken op ... > Bewerken.
Wijzig in het dialoogvenster Webhook bewerken de webhook naar wens.
Klik op Opslaan.

Mobiel

Tik in de Shopify-app op en tik vervolgens op Instellingen.
Tik in de sectie Winkelinstellingen op Meldingen.
Tik op Webhooks.
Tik in de rij met de webhook die je wilt bewerken op ... > Bewerken.
Wijzig in het dialoogvenster Webhook bewerken de webhook naar wens.
Tik op Opslaan of ✓.

Webhooks testen

Je kunt je webhook testen om er zeker van te zijn dat de gewenste gebeurtenisgegevens naar de juiste URL worden verzonden.

Stappen:

Desktop

Ga in je Shopify-beheercentrum naar Instellingen > Meldingen.
Klik op Webhooks.
Klik in de rij met de webhook die je wilt testen op ... > Test verzenden.
Controleer op de URL die je hebt opgegeven voor de webhook of de melding werkt.

Mobiel

Tik in de Shopify-app op en tik vervolgens op Instellingen.
Tik in de sectie Winkelinstellingen op Meldingen.
Tik op Webhooks.
Tik in de rij met de webhook die je wilt testen op ... > Test verzenden.
Controleer op de URL die je hebt opgegeven voor de webhook of de melding werkt.

Webhooks verwijderen

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

Stappen:

Desktop

Ga in je Shopify-beheercentrum naar Instellingen > Meldingen.
Klik op Webhooks.
Klik in de rij met de webhook die je wilt verwijderen op ... > Verwijderen.

Mobiel

Tik in de Shopify-app op en tik vervolgens op Instellingen.
Tik in de sectie Winkelinstellingen op Meldingen.
Tik op Webhooks.
Tik in de rij met de webhook die je wilt verwijderen op ... > Verwijderen.