Trigger voor metaveld ‘Bestelling’

Trigger voor metaveld ‘Bestelling’

Pagina kopiëren

Start een Shopify Flow-workflow zodra een metaveld van een bestelling verandert, zoals een cadeaubericht, en gebruik de oude en nieuwe waarde.

Een klant vraagt de support om een cadeaubericht toe te voegen nadat de bestelling is geplaatst. De support voert dit in het metaveld Cadeaubericht (custom.gift_message) van de bestelling in, en het verpakkingsteam moet dit zien voordat het pakket wordt verzonden.

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 bestelling verandert. De stappen zijn voor elk metaveld van dit resourcetype hetzelfde; in het voorbeeld wordt gebruikgemaakt van het veld Cadeaubericht (custom.gift_message).

Wat u nodig hebt

  • Een metaveld-definitie. U kunt deze aanmaken in uw Shopify-beheeromgeving onder Instellingen > Metavelden en meta-objecten > Bestellingen. Een metaveld zonder definitie kan niet worden bijgehouden.
  • De machtiging Toegang tot gegevens. Verleen deze machtiging op de pagina Machtigingen van de app; zie Toestemmingen en toegang tot gegevens.

1. Houd het metaveld bij

  1. Open Metaveld-triggers in de app en klik op Trigger toevoegen.
  2. Kies het resourcetype Bestelling.
  3. Vink het metaveld aan, in dit geval Cadeaubericht. U kunt meerdere velden tegelijk aanvinken of de optie Alles selecteren gebruiken.
  4. 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.

Het dialoogvenster „Trigger voor metaveld toevoegen“ met het resourcetype „Bestelling“ en het metaveld „Gift message“ (custom.gift_message), aangevinkt
Resourcetype ‘Bestelling’, het metaveld is aangevinkt. Bij ‘Alle metavelden’ worden in plaats daarvan alle metavelden van dit type bijgehouden.

De nieuwe trigger geeft Initializing weer terwijl de app de huidige waarde van het metaveld in uw bestaande bestellingen 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 ORDER
resourceId Het ID van de bestelling, bijvoorbeeld gid://shopify/Order/1234567890
metafieldKey Naamruimte en sleutel, in dit geval custom.gift_message
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

'Bestelling Metaveld Update' is een tweede trigger voor dezelfde wijziging. Deze wordt naast 'Metaveld Update' gestart en bevat de bestelling als een native Flow-referentie, waardoor de eigen bestellingsacties 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

  1. Maak in Shopify Flow een workflow aan en kies de trigger Metaveld Update van Workflow Trigger Extensions.
  2. Voeg een voorwaarde toe: resourceType is gelijk aan ORDER. De workflow ‘Metaveld Update’ wordt gestart voor elk resourcetype dat u bijhoudt; deze voorwaarde zorgt ervoor dat de workflow beperkt blijft tot bestellingen. Wanneer u meerdere metavelden van dit type bijhoudt, voeg dan metafieldKey is gelijk aan custom.gift_message toe als tweede criterium.
  3. Voeg de gewenste actie toe. In het voorbeeld wordt een interne e-mail verzonden met de oude en de nieuwe waarde.
De voorbeeldworkflow in Shopify Flow: Metaveld bijwerken, een voorwaarde voor het resourcetype ORDER en een interne e-mail verzenden
De voorbeeldworkflow: de trigger, de voorwaarde op basis van het resourcetype en één actie.

Begin met het voorbeeld

  1. Download het .flow-bestand dat onderaan deze pagina is bijgevoegd.
  2. Open Shopify Flow in uw Shopify-beheerdersgedeelte, klik op Importeren en selecteer het bestand.
  3. Open de stap Interne e-mail verzenden en voer de ontvanger in. Het bestand bevat bewust geen adres.
  4. Schakel de workflow in.

Maak het tot het uwe

  • De bestelling labelen: voer de actie Bestelling labelen uit en voer {{resourceId}} in het betreffende veld in.
  • Voeg de voorwaarde „metafield.value is niet leeg” toe, zodat er bij een verwijderd bericht niets wordt verzonden.
  • Gebruik Order Metaveld Update wanneer de workflow de artikelen of het afleveradres moet uitlezen.

Hoe snel reageert het?

Shopify stelt de app op de hoogte wanneer een bestelling wordt opgeslagen, zodat de workflow doorgaans binnen enkele seconden van start gaat.

Goed om te weten

  • Standaard houdt de app bestellingen bij die in de afgelopen 60 dagen zijn aangemaakt. Voor oudere bestellingen is volledige toegang tot de bestelgeschiedenis op de pagina ‘Toestemmingen’ vereist, evenals een langere periode in de instelling voor de bestelgeschiedenis van de app.

Meer