Metafield-triggers, stap voor stap

Metavelden zijn de plekken waar een winkel gegevens opslaat waarvoor Shopify geen veld heeft, en Shopify Flow kan niet reageren op wijzigingen daarin. Deze vijf triggers kunnen dat wel - en ze bevatten previousValue, zodat een workflow een stijging van een daling kan onderscheiden.

Ze werken allemaal per definitie: je kiest zelf welke metafields je wilt volgen op de pagina ‘Metafield Triggers’ van de app. Er wordt niets geactiveerd voor een metafield dat je daar niet hebt toegevoegd. Zie Metafield-triggers voor de instellingen.

Op deze pagina: Metafield-update, Product-metafield-update, Productvariant-metafield-update, Bestelling-metafield-update, Klant-metafield-update

Waar je ze kunt vinden: ga naar Shopify Flow, kies ‘Select a trigger’, open Workflow Trigger Extensions en zoek naar ‘Metafield’.

Metafield-update

Wordt geactiveerd wanneer een bekeken metafield verandert, ongeacht het type eigenaar: product, variant, collectie, klant, bestelling, conceptbestelling, bedrijf, bedrijfsvestiging, blog, blogbericht of pagina.


Branden veroorzaakt door	Shopify Webhook plus wijzigingsdetectie. De metavelden van varianten, blogs, blogberichten en pagina’s worden volgens een vast schema gecontroleerd
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Per metafield-definitie, op de pagina ‘Metafield-triggers’ van de app

Gebruik het voor

Soorten eigenaren zonder getypeerde trigger: collecties, bedrijven, pagina’s, blogberichten.
Een workflow die verschillende metavelden in de gaten houdt en vertakt op basis van metafieldKey.

Wat Metafield Update naar je workflow verstuurt

Variabele doorstroming	Type	Wat erin zit
`metafieldKey`	Tekst	De `namespace.key` van het metafield dat is bijgewerkt (voor filtering in Flow)
`resourceType`	Tekst	Het type bron (PRODUCT, PRODUCTVARIANT, COLLECTION, CUSTOMER, ORDER, COMPANY, COMPANYLOCATION, ARTICLE, BLOG, PAGE)
`resourceId`	Tekst	De GID van de bron die is bijgewerkt
`metafield`	Voorwerp	Het metaveld dat is bijgewerkt
`metafield.id`	ID	Globale ID van het metaveld
`metafield.namespace`	Tekst	De naamruimte van het metaveld
`metafield.key`	Tekst	De sleutel van het metaveld
`metafield.value`	Tekst	De waarde van het metaveld
`metafield.previousValue`	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
`metafield.type`	Tekst	Het type van het metaveld
`eventId`	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om te zien wat er precies is verzonden.

Voorbeeld: reageren op een gewijzigd metaveld in een collectie

Open in de app ‘Metafield Triggers’, klik op ‘Trigger toevoegen’, kies het eigenaartype ‘Collectie’ en de definitie, en sla op.
Kies in Flow ‘Metafield Update’ als trigger.
Voeg een voorwaarde toe: metafieldKey is gelijk aan custom.banner_text en resourceType is gelijk aan COLLECTION.
Voeg ‘Interne e-mail verzenden’ toe met {{metafield.previousValue}} -> {{metafield.value}} en {{resourceId}}.
Schakel de workflow in.

Update van productmetavelden

Wordt geactiveerd wanneer een metafield van een gevolgd product verandert, waarbij het product als native Flow-referentie fungeert.


Branden door	Shopify webhook plus wijzigingsdetectie
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Als je een Flow-workflow inschakelt die deze functie gebruikt, wordt deze geactiveerd. De eigen schakelaar bevindt zich op de pagina ‘Triggers’ van de app.

Gebruik het voor

Voer direct een actie uit op het product: voeg een tag toe, publiceer het of werk een ander metaveld bij.
Drempelwaarden voor numerieke metavelden: een beoordeling, een voorraadprognose, een levertijd van een leverancier.

Wat de update van het productmetaveld naar je workflow stuurt

Variabele doorstroming	Type	Wat erin zit
`product`	Product (Shopify)	Het product waarvan het metaveld is gewijzigd. Een volledig Shopify-product, zodat alle velden ervan en de eigen productacties van Flow beschikbaar zijn.
`metafieldKey`	Tekst	De 'namespace.key' van het metaveld dat is gewijzigd (voor het filteren in Flow)
`metafield`	Voorwerp	Het metaveld dat is bijgewerkt
`metafield.id`	ID	Globale ID van het metaveld
`metafield.namespace`	Tekst	De naamruimte van het metaveld
`metafield.key`	Tekst	De sleutel van het metaveld
`metafield.value`	Tekst	De waarde van het metaveld
`metafield.previousValue`	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
`metafield.type`	Tekst	Het type van het metaveld
`eventId`	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om te zien wat er precies is verzonden.

Voorbeeld: Producten markeren waarvan de beoordeling lager is dan 3

Voeg het productmetaveld toe op de pagina ‘Metaveldtriggers’ van de app.
Selecteer ‘Productmetaveld bijwerken’ in Flow.
Een voorwaarde toevoegen: metafieldKey is gelijk aan reviews.rating.
Voeg** de code** toe om getallen te vergelijken, omdat de waarden van metavelden als tekst worden weergegeven: return dropped: Number(input.metafield.value) < 3 && Number(input.metafield.previousValue) >= 3.
Voeg een voorwaarde toe aan de uitvoer van de code dropped en voeg vervolgens producttags toe via low-rating.
Schakel de workflow in.

Het dialoogvenster ‘Trigger voor metafield toevoegen’ met het resourcetype ‘Product’ en de metafields ‘Rating’ en ‘custom.rating’ geselecteerd — Bekijk eerst het metaveld in de app: Metaveld-triggers, Trigger toevoegen, Product, Beoordeling.

Een gebeurtenis in de gebeurtenisgeschiedenis: Metafield-update voor een product, waarde 2,5 en vorige waarde 4,5 — De gebeurtenis waarop dit voorbeeld reageert: de beoordeling is gedaald van 4,5 naar 2,5, waardoor de grens van 3 is overschreden.

Update van het metafield ‘Productvariant’

Wordt geactiveerd wanneer een gevolgd variant-metaveld verandert. Het bovenliggende product wordt als referentie doorgegeven, de variant als resourceId.


Branden veroorzaakt door	Dit wordt volgens een schema gecontroleerd, omdat Shopify hiervoor geen webhook verstuurt
Toestemming	Toegang tot product-, variant- en collectiegegevens
Ingeschakeld	Als je een Flow-workflow inschakelt waarin deze functie wordt gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar vind je op de pagina ‘Triggers’ van de app.

Gebruik het voor

Voeg de gegevens van de varianten samen op productniveau, bijvoorbeeld de kortste levertijd van alle varianten.
Attributen op variantniveau synchroniseren met een feed.

Welke gegevens stuurt de update van het metafield ‘Productvariant’ naar je workflow?

Variabele doorstroming	Type	Wat erin zit
`product`	Product (Shopify)	Het bovenliggende product van de variant waarvan het metaveld is gewijzigd (gebruik dit om productmetavelden te schrijven). Een volledig Shopify-product, zodat alle velden ervan en de eigen productacties van Flow beschikbaar zijn.
`resourceId`	Tekst	De GID van de productvariant waarvan het metaveld is gewijzigd
`metafieldKey`	Tekst	De `namespace.key` van het metafield dat is gewijzigd (voor het filteren in Flow)
`metafield`	Voorwerp	Het metaveld dat is bijgewerkt
`metafield.id`	ID	Globale ID van het metaveld
`metafield.namespace`	Tekst	De naamruimte van het metaveld
`metafield.key`	Tekst	De sleutel van het metaveld
`metafield.value`	Tekst	De waarde van het metaveld
`metafield.previousValue`	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld net is aangemaakt
`metafield.type`	Tekst	Het type van het metaveld
`eventId`	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om te zien wat er precies is verzonden.

Voorbeeld: een variantmetaveld kopiëren naar het bijbehorende product

Voeg het variant-metaveld toe op de pagina ‘Metaveld-triggers’.
Selecteer ‘Productvariant-metaveld bijwerken’ in Flow.
Voeg het metaveld ‘Update product’ toe op product met de waarde {{metafield.value}}.
Schakel de workflow in.

Metafield-update aanvragen

Wordt geactiveerd wanneer een metafield van een gevolgde order verandert, waarbij de order als native-referentie fungeert.


Branden veroorzaakt door	Shopify webhook plus wijzigingsdetectie
Toestemming	Toegang tot bestelgegevens
Ingeschakeld	Als je een Flow-workflow inschakelt waarin deze functie wordt gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar vind je op de pagina ‘Triggers’ van de app.

Gebruik het voor

Reageer op gegevens die apps aan bestellingen toevoegen: een leverdatum, een risicoscore, een ERP-nummer.
Start de afhandelingsstappen zodra een goedkeuringsmetaveld verandert.

Welke opdracht 'Metafield Update' naar je workflow verstuurt

Variabele doorstroming	Type	Wat erin zit
`order`	Bestelling (Shopify)	De bestelling waarvan het metaveld is gewijzigd. Een volledige Shopify-bestelling, zodat alle velden en de eigen bestellingsacties van Flow beschikbaar zijn.
`metafieldKey`	Tekst	De `namespace.key` van het metaveld dat is gewijzigd (voor het filteren in Flow)
`metafield`	Voorwerp	Het metaveld dat is bijgewerkt
`metafield.id`	ID	Globale ID van het metaveld
`metafield.namespace`	Tekst	De naamruimte van het metaveld
`metafield.key`	Tekst	De sleutel van het metaveld
`metafield.value`	Tekst	De waarde van het metaveld
`metafield.previousValue`	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
`metafield.type`	Tekst	Het type van het metaveld
`eventId`	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om te zien wat er precies is verzonden.

Voorbeeld: een bestelling vrijgeven wanneer het metaveld ‘goedkeuring’ de waarde ‘waar’ krijgt

Voeg het meta-veld ‘order’ toe op de pagina ‘Metafield Triggers’.
Metaveld ‘Pick Order’ bijwerken in Flow.
Voeg een voorwaarde toe: metafieldKey is gelijk aan custom.approved en metafield.value is gelijk aan true.
Voeg een ‘For each’-lus toe voor order.fulfillmentOrders met de optie ‘Vervolledigingsorder blokkeren’.
Schakel de workflow in.

Update van het metafield van de klant

Wordt geactiveerd wanneer een in de gaten gehouden metaveld van een klant verandert, waarbij de klant als native referentie fungeert.


Branden veroorzaakt door	Shopify webhook plus wijzigingsdetectie
Toestemming	Toegang tot klantgegevens
Ingeschakeld	Als je een Flow-workflow inschakelt die deze functie gebruikt, wordt deze geactiveerd. De bijbehorende schakelaar vind je op de pagina ‘Triggers’ van de app.

Gebruik het voor

Loyaliteitsniveaus, kredietlimieten of verjaardagen die in metafields worden opgeslagen.
Synchroniseer klantkenmerken die via formulieren of apps zijn ingevoerd met een CRM-systeem.

Wat de ‘Customer Metafield Update’ naar je workflow verstuurt

Variabele doorstroming	Type	Wat erin zit
`customer`	Klant (Shopify)	De klant wiens metaveld is gewijzigd. Een ‘full-Shopify’-klant, dus alle velden en de eigen klantacties van Flow zijn beschikbaar.
`metafieldKey`	Tekst	De `namespace.key` van het metaveld dat is gewijzigd (voor filtering in Flow)
`metafield`	Voorwerp	Het metaveld dat is bijgewerkt
`metafield.id`	ID	Globale ID van het metaveld
`metafield.namespace`	Tekst	De naamruimte van het metaveld
`metafield.key`	Tekst	De sleutel van het metaveld
`metafield.value`	Tekst	De waarde van het metaveld
`metafield.previousValue`	Tekst	De waarde vóór deze wijziging. Null wanneer het metaveld zojuist is aangemaakt
`metafield.type`	Tekst	Het type van het metaveld
`eventId`	Tekst	De ID van deze gebeurtenis. Zoek deze op in de gebeurtenisgeschiedenis van de app om precies te zien wat er is verzonden.

Voorbeeld: Klanten markeren die het gouden niveau hebben bereikt

Voeg het metaveld ‘klant’ toe op de pagina ‘Metaveld-triggers’.
Kies ‘Klantmetaveld bijwerken’ in Flow.
Voeg een voorwaarde toe: metafieldKey is gelijk aan loyalty.tier en metafield.value is gelijk aan gold.
Voeg de klanttags gold toe en stuur een interne e-mail naar het VIP-team.
Schakel de workflow in.

Volgende stappen

De typespecifieke triggers worden naast de algemene trigger geactiveerd en delen dezelfde gebeurtenis, dus als je beide inschakelt, telt dit niet dubbel mee voor je abonnement.

Volledig overzicht van de trekkers - alle triggers op één pagina.
De juiste trekker kiezen - welke het beste bij jouw situatie past.
Aangepaste triggers - als er geen ingebouwde trigger geschikt is, schrijf dan je eigen trigger.
Gebeurtenisgeschiedenis en probleemoplossing - kijk wat er is afgevuurd en wat het vervoerde.