Trigger voor metaveld van klant
Start een Shopify Flow-workflow wanneer een metaveld van een klant verandert. Volg dit in Workflow Trigger Extensions en bekijk de oude en de nieuwe waarde.
Een modewinkel biedt klanten de mogelijkheid om hun maat op te slaan in het metaveld Kledingmaat (custom.clothing_size). Wanneer een klant deze maat wijzigt, wil de winkel hierop inspelen, bijvoorbeeld door producten in de nieuwe maat aan te bieden.
Op deze pagina wordt uitgelegd hoe u met behulp van Workflow Trigger Extensions een Shopify Flow-workflow kunt starten telkens wanneer een metaveld van een klant verandert. De stappen zijn voor elk metaveld van dit resourcetype hetzelfde; in het voorbeeld wordt gebruikgemaakt van Kledingmaat (custom.clothing_size).
Wat u nodig hebt
- Een metavelddefinitie. U kunt deze aanmaken in uw Shopify-beheerdersgedeelte onder Instellingen > Metavelden en meta-objecten > Klanten. Een metaveld zonder definitie kan niet worden bijgehouden.
- De machtiging Toegang tot klantgegevens. Verleen deze machtiging op de pagina Machtigingen van de app; zie Toestemmingen en toegang tot gegevens.
1. Houd het metaveld bij
- Open Metaveld-triggers in de app en klik op Trigger toevoegen.
- Kies het resourcetype Klant.
- Vink het metaveld aan, in dit geval Kledingmaat. U kunt meerdere velden tegelijk aanvinken of de optie Alles selecteren gebruiken.
- Klik op Trigger toevoegen.
Om elk metaveld van dit resourcetype bij te houden, inclusief de velden die u later aanmaakt, selecteert u Alle metavelden in plaats van afzonderlijke velden aan te vinken, en klikt u vervolgens op Alle metavelden bijhouden.

De nieuwe trigger geeft Initializing weer terwijl de app de huidige waarde van het metaveld van uw bestaande klanten uitleest, en vervolgens Active. Die eerste uitlezing is de reden waarom de allereerste wijziging al met de juiste vorige waarde binnenkomt.
Indien het metaveld ontbreekt in de lijst, klikt u op Metavelden vernieuwen op de pagina ‘Metaveldtriggers’: de app onthoudt de lijst met definities gedurende een uur.
2. Wat de workflow ontvangt
Elke wijziging activeert de trigger Metaveld Update in Shopify Flow met de volgende waarden:
| Variabele | Waarde |
|---|---|
resourceType |
CUSTOMER |
resourceId |
Het ID van de klant, bijvoorbeeld gid://shopify/Customer/1234567890 |
metafieldKey |
Naamruimte en sleutel, in dit geval custom.clothing_size |
metafield.value |
De nieuwe waarde |
metafield.previousValue |
De waarde vóór de wijziging; leeg wanneer het metaveld voor het eerst werd ingesteld |
metafield.type |
Het type van het metaveld, bijvoorbeeld single_line_text_field |
Customer Metafield Update is een tweede trigger voor dezelfde wijziging. Deze wordt naast ‘Metafield Update’ gestart en bevat de klant als een native Flow-referentie, waardoor de eigen klantacties van Shopify hierop kunnen worden toegepast zonder dat er een opzoekstap nodig is. Beide delen één gebeurtenis, dus het gebruik van beide wordt niet dubbel geteld. Schakel deze functie in via de pagina Triggers van de app, of activeer een workflow die hiervan gebruikmaakt.
3. Stel de workflow samen
- Maak in Shopify Flow een workflow aan en kies de trigger Metaveld Update van Workflow Trigger Extensions.
- Voeg een voorwaarde toe:
resourceTypeis gelijk aanCUSTOMER. De workflow ‘Metaveld Update’ wordt gestart voor elk resourcetype dat u bijhoudt; deze voorwaarde zorgt ervoor dat de workflow beperkt blijft tot klanten. Wanneer u meerdere metavelden van dit type bijhoudt, voeg danmetafieldKeyis gelijk aancustom.clothing_sizetoe als tweede criterium. - Voeg de gewenste actie toe. In het voorbeeld wordt een interne e-mail verzonden met de oude en de nieuwe waarde.

Begin met het voorbeeld
- Download het
.flow-bestand dat onderaan deze pagina is bijgevoegd. - Open Shopify Flow in uw Shopify-beheerdersgedeelte, klik op Importeren en selecteer het bestand.
- Open de stap Interne e-mail verzenden en voer de ontvanger in. Het bestand bevat bewust geen adres.
- Schakel de workflow in.
Maak het tot het uwe
- De klant taggen: voer de actie Klanttags toevoegen uit en voer
{{resourceId}}in het klantveld in. - Gebruik de functie Klantmetaveld bijwerken wanneer de workflow aanvullende gegevens van de klant moet ophalen, zoals het e-mailadres.
- Voeg een voorwaarde toe voor
metafield.value, zodat er slechts op één maat wordt gereageerd.
Hoe snel reageert het?
Shopify geeft de app een melding wanneer een klant wordt opgeslagen, zodat de workflow doorgaans binnen enkele seconden van start gaat.
Goed om te weten
- Een klant die wordt aangemaakt terwijl het metaveld al is ingevuld - bijvoorbeeld via een aanmeldingsformulier - zet de workflow één keer in gang, met een lege vorige waarde.
Meer
- Metaveld-triggers : hoe metafield-triggers werken, voor elk type resource.
- Shopify Flow's activeren bij wijzigingen in metafields van klanten : een praktijkvoorbeeld met een video.
- Gebeurtenisgeschiedenis en probleemoplossing : bekijk alle gebeurtenissen die de app heeft verzonden, met zowel de oude als de nieuwe waarde.
