Shopify Next Generation Events: granularni webhooks s GraphQL

Problem tradicionalnih Shopify webhookova

Svaki tko je izgradio ERP ili PIM integraciju na Shopifyju poznaje ovaj problem: svaki put kada se proizvod ažurira, webhook ispalje cijeli payload, čak i ako se promijenio samo tag ili metafield koji nije relevantan za sustav koji prima podatke.

To stvara tri konkretne neučinkovitosti:

• Veliki volumen nedjelotvorniih isporuka koje troše mrežne i procesorske resurse
• Strukturalni over-fetching, s nepotrebnim poljima koja se prenose uz svaki događaj
• Aplikacijska diff logika, potrebna kako bi se utvrdilo što se zapravo promijenilo u odnosu na prethodno stanje

Next Generation Events, sada dostupni u developer previewu u Shopify Admin GraphQL API-ju, izravno rješavaju ova tri problema.

Tri dimenzije granularne kontrole

Novi sustav uvodi kontrolu na tri zasebne razine: što pokreće isporuku, što payload sadržava i što se promijenilo.

1. Okidači na razini polja (field-level triggers)

S Next Generation Eventsima moguće je definirati pretplatu na specifičnu putanju poput product.variants.price. Pretplata konfigurirana na ovaj način ne aktivira se pri izmjenama naslova, tagova ili drugih polja — aktivira se isključivo kada se promijeni cijena varijanti.

Ovo u korijenu eliminira kategoriju lažnih isporuka, bez potrebe za filterima na strani aplikacije.

2. Prilagođeni payload putem GraphQL upita

Umjesto primanja fiksnog payloada kojeg određuje Shopify, s novim sustavom izravno definirate GraphQL upit koji popunjava svaku isporuku. Rezultat je da svaki događaj sadrži točno ona polja potrebna za obradu, bez suvišnih polja i bez potrebe za dodatnim API pozivom kako bi se dohvatili nedostajući podaci.

Za integracije koje danas slijede obrazac webhook + API poziv za obogaćivanje, ovo predstavlja neto smanjenje broja zahtjeva prema Shopify API-ju.

3. Polje fields_changed

Svaka isporuka sada uključuje polje fields_changed s eksplicitnim popisom promijenjenih putanja, uključujući punu putanju i ID entiteta. Time postaje zastarjela svaka logika usporedbe s prethodnim stanjem u aplikacijskom kodu.

Umjesto održavanja lokalnog snapshotа entiteta i računanja diffa uz svaki događaj, sustav koji prima podatke može izravno pročitati koja su se polja promijenila i djelovati prema tome.

query_filter: smanjenje nedjelotvornih isporuka

Dodatni mehanizam kontrole je query_filter, koji omogućuje filtriranje isporuka na temelju trenutnog stanja entiteta u trenutku događaja. Tipičan primjer: isporučivati događaje samo za proizvode sa statusom ACTIVE, ignorirajući nacrte i arhivirane proizvode.

U kombinaciji s okidačima na razini polja, query_filter omogućuje izgradnju vrlo preciznih pretplata, smanjujući promet prema prijemnim endpointima na djelić trenutnog volumena.

Config as code s shopify.app.toml

Next Generation Events pretplate konfiguriraju se izravno u datoteci shopify.app.toml, zajedno s ostatkom konfiguracije aplikacije. To znači da je definicija događaja:

• Verzionabilna u repozitoriju projekta
• Preglediva u procesu code reviewa
• Reproducibilna u različitim okruženjima bez ručnih konfiguracija

Za timove koji upravljaju višestrukim okruženjima (razvoj, staging, produkcija) ili koji slijede GitOps prakse, ovaj pristup eliminira ovisnost o ručno upravljanim konfiguracijama u Shopify dashboardu.

Praktični utjecaj za ERP i PIM integracije

Za kataloge visokog volumena, zbroj ovih promjena ima mjerljiv utjecaj na performanse i troškove:

• Smanjenje broja primljenih isporuka zahvaljujući preciznim okidačima i query_filteru
• Smanjenje prosječne veličine payloada zahvaljujući prilagođenim GraphQL upitima
• Eliminacija API poziva za obogaćivanje nakon isporuke
• Pojednostavljivanje aplikacijskog koda zahvaljujući fields_changed

Integracije koje danas obrađuju tisuće događaja dnevno s niskom stopom djelotvornosti one su koje najviše profitiraju od ove arhitekture.

Preporuke za one koji počinju danas

Sustav je trenutno u developer previewu na Shopify unstable API-ju, s podrškom za topice Product i Customer. Prije procjene usvajanja:

• Provjerite trenutni promet: identificirajte webhookove s visokim volumenom i niskom iskoristivošću payloada — oni su prioritetni kandidati za migraciju
• Testirajte u previewu: koristite danas dostupne topice Product i Customer za validaciju očekivanog ponašanja
• Zamijenite diff logiku: refaktoring vođen fields_changed na postojećim consumerima
• Konfigurirajte query_filter: definirajte kriterije filtriranja prema trenutnom stanju kako biste eliminirali nedjelotovrne isporuke
• Planirajte migraciju: API je na unstable verziji i nije prikladan za produkciju bez plana migracije prema stabilnoj verziji

Ako gradite ili razvijate prilagođene integracije na Shopify Plusu i želite procijeniti arhitekturu najprikladniju za vaš volumen i zahtjeve, informacije o našim razvojnim uslugama možete pronaći na stranici za Shopify developere.

Zaključak

Next Generation Events nisu samo poboljšanje performansi webhookova — redefiniaju model integracije sa Shopifyjem, premještajući granularnu kontrolu na stranu developera. Za one koji grade ozbiljne integracije na katalozima visokog volumena, vrijedi istražiti ovaj obrazac već sada, prije nego što dosegne stabilnost i postane očekivani standard.