Shopify Next Generation Events: granulaire webhooks met GraphQL

Het probleem met traditionele Shopify-webhooks

Iedereen die een ERP- of PIM-integratie op Shopify heeft gebouwd, kent het probleem: telkens wanneer een product wordt bijgewerkt, stuurt de webhook de volledige payload mee, zelfs als alleen een tag of een irrelevante metafield is gewijzigd.

Dit leidt tot drie concrete inefficiënties:

• Hoog volume aan niet-bruikbare deliveries, die netwerk- en verwerkingsbronnen verbruiken
• Structurele over-fetching, waarbij onnodige velden bij elk event worden meegestuurd
• Applicatie-niveau diff-logica, noodzakelijk om te bepalen wat er daadwerkelijk is veranderd ten opzichte van de vorige toestand

De Next Generation Events, nu beschikbaar als developer preview op de Shopify Admin GraphQL API, pakken deze drie problemen direct aan.

Drie dimensies van granulaire controle

Het nieuwe systeem introduceert controle op drie afzonderlijke niveaus: wat een delivery triggert, wat de payload bevat en wat er is gewijzigd.

1. Field-level triggers

Met Next Generation Events kun je een subscription definiëren op een specifiek pad zoals product.variants.price. Een subscription die op deze manier is geconfigureerd, wordt niet geactiveerd bij wijzigingen in de titel, tags of andere velden: hij wordt uitsluitend getriggerd wanneer de prijs van varianten verandert.

Dit elimineert aan de bron de categorie van overbodige deliveries, zonder dat applicatiefilters nodig zijn.

2. Aangepaste payload via GraphQL-query

In plaats van een vaste payload te ontvangen die door Shopify wordt bepaald, definieer je met het nieuwe systeem zelf de GraphQL-query die elke delivery vult. Het resultaat is dat elk event precies de velden bevat die nodig zijn voor verwerking, zonder overbodige velden en zonder extra API-aanroep om ontbrekende gegevens op te halen.

Voor integraties die vandaag het patroon webhook + verrijkende API-aanroep volgen, betekent dit een netto vermindering van het aantal verzoeken naar de Shopify API.

3. Het veld fields_changed

Elke delivery bevat nu een veld fields_changed met de expliciete lijst van gewijzigde paden, inclusief volledig pad en entiteits-ID. Dit maakt elke vergelijkingslogica met de vorige toestand in de applicatiecode overbodig.

In plaats van een lokale snapshot van de entiteit bij te houden en bij elk event een diff te berekenen, kan het ontvangende systeem direct aflezen welke velden zijn gewijzigd en daarop handelen.

query_filter: niet-bruikbare deliveries verminderen

Een extra controlemechanisme is de query_filter, waarmee deliveries kunnen worden gefilterd op basis van de huidige toestand van de entiteit op het moment van het event. Een typisch voorbeeld: deliveries alleen uitvoeren voor producten met status ACTIVE, terwijl concepten en gearchiveerde producten worden genegeerd.

Gecombineerd met field-level triggers maakt query_filter het mogelijk zeer gerichte subscriptions te bouwen, waardoor het verkeer naar de ontvangende endpoints wordt teruggebracht tot een fractie van het huidige volume.

Config as code met shopify.app.toml

Next Generation Events-subscriptions worden rechtstreeks geconfigureerd in het bestand shopify.app.toml, samen met de rest van de applicatieconfiguratie. Dit betekent dat de definitie van events:

• Versioneerbaar is in de projectrepository
• Reviewbaar is in het code review-proces
• Reproduceerbaar is in verschillende omgevingen zonder handmatige configuratie

Voor teams die meerdere omgevingen beheren (ontwikkeling, staging, productie) of GitOps-praktijken volgen, elimineert deze aanpak de afhankelijkheid van handmatig beheerde configuraties in het Shopify-dashboard.

Praktische impact voor ERP- en PIM-integraties

Voor catalogi met hoog volume heeft de combinatie van deze wijzigingen een meetbare impact op prestaties en kosten:

• Vermindering van het aantal ontvangen deliveries dankzij precieze triggers en query_filter
• Vermindering van de gemiddelde payloadgrootte dankzij aangepaste GraphQL-queries
• Eliminatie van verrijkende API-aanroepen na delivery
• Vereenvoudiging van de applicatiecode dankzij fields_changed

Integraties die vandaag duizenden events per dag verwerken met een lage bruikbaarheidsgraad profiteren het meest van deze architectuur.

Aanbevelingen voor wie vandaag begint

Het systeem bevindt zich momenteel in developer preview op de unstable API van Shopify, met ondersteuning voor de topics Product en Customer. Overweeg vóór adoptie het volgende:

• Analyseer je huidige verkeer: identificeer webhooks met hoog volume en lage payloadbruikbaarheid, dit zijn de prioritaire kandidaten voor migratie
• Test in preview: gebruik de vandaag beschikbare topics Product en Customer om het verwachte gedrag te valideren
• Vervang diff-logica: refactor bestaande consumers op basis van fields_changed
• Configureer query_filter: definieer filtercriteria op de huidige toestand om niet-bruikbare deliveries te elimineren
• Plan de migratie: de API bevindt zich op unstable en is niet geschikt voor productie zonder een migratieplan naar een stabiele versie

Als je aangepaste integraties op Shopify Plus bouwt of verder ontwikkelt en wilt beoordelen welke architectuur het beste past bij jouw volume en vereisten, vind je meer informatie over onze ontwikkeldiensten op de pagina voor Shopify-ontwikkelaars.

Conclusie

Next Generation Events zijn niet alleen een prestatieverbetering voor webhooks: ze herdefiniëren het integratiemodel met Shopify en verleggen granulaire controle naar de kant van de ontwikkelaar. Voor wie serieuze integraties bouwt op catalogi met hoog volume, loont het dit patroon nu al te verkennen, voordat het stabiel wordt en de verwachte standaard is.