Trigger für Metafeld „Bestellung“

Trigger für Metafeld „Bestellung“

Seite kopieren

Starten Sie einen Shopify Flow-Workflow, sobald sich ein Metafeld einer Bestellung ändert, und nutzen Sie den alten und neuen Wert im Workflow.

Ein Kunde bittet den Support, nach der Bestellung eine Geschenknotiz hinzuzufügen. Der Support trägt diese in das Metafeld Geschenknotiz (custom.gift_message) der Bestellung ein, und das Verpackungsteam muss diese sehen, bevor das Paket versandt wird.

Auf dieser Seite wird erläutert, wie Sie mithilfe der Workflow Trigger Extensions-Erweiterungen einen Shopify Flow-Workflow auslösen können, sobald sich ein Metafeld einer Bestellung ändert. Die Schritte sind für jedes Metafeld dieses Ressourcentyps identisch; im Beispiel wird das Metafeld Geschenknachricht (custom.gift_message) verwendet.

Was Sie benötigen

  • Eine Metafeld-Definition. Erstellen Sie diese in Ihrem Shopify-Adminbereich unter Einstellungen > Metafelder und Metaobjekte > Bestellungen. Ein Metafeld ohne Definition kann nicht nachverfolgt werden.
  • Die Berechtigung Datenzugriff. Erteilen Sie diese auf der Seite Berechtigungen der App; siehe Berechtigungen und Datenzugriff.

1. Verfolgen Sie das Metafeld

  1. Öffnen Sie in der App Metafeld-Trigger und klicken Sie auf Trigger hinzufügen.
  2. Wählen Sie den Ressourcentyp Bestellung aus.
  3. Aktivieren Sie das Metafeld Geschenkbotschaft. Sie können mehrere Felder gleichzeitig aktivieren oder die Option Alle auswählen verwenden.
  4. Klicken Sie auf Trigger hinzufügen.

Um alle Metafelder dieses Ressourcentyps zu verfolgen, einschließlich derer, die Sie später erstellen, wählen Sie Alle Metafelder anstelle einzelner Metafelder aus und klicken Sie anschließend auf Alle Metafelder verfolgen.

Das Dialogfeld „Metafeld-Trigger hinzufügen“ mit dem Ressourcentyp „Bestellung“ und dem Metafeld „Geschenknachricht“ (custom.gift_message), das markiert ist
Ressourcentyp „Bestellung“, das Metafeld ist angekreuzt. „Alle Metafelder“ erfasst stattdessen jedes einzelne Metafeld dieses Typs.

Der neue Trigger zeigt Initialisierung an, während die App den aktuellen Wert des Metafelds in Ihren bestehenden Bestellungen ausliest, und wechselt anschließend zu Aktiv. Aufgrund dieses ersten Lesevorgangs wird bereits bei der allerersten Änderung der richtige vorherige Wert übermittelt.

Sollte das Metafeld in der Liste fehlen, klicken Sie auf der Seite „Metafeld-Trigger“ auf Metafelder aktualisieren: Die App speichert die Liste der Definitionen eine Stunde lang.

2. Was der Workflow empfängt

Jede Änderung löst in Shopify Flow den Trigger Metafield Update mit folgenden Werten aus:

Variable Wert
resourceType ORDER
resourceId Die ID der Bestellung, zum Beispiel gid://shopify/Order/1234567890
metafieldKey Namensraum und Schlüssel, hier custom.gift_message
metafield.value Der neue Wert
metafield.previousValue Der Wert vor der Änderung; leer, wenn das Metafeld zum ersten Mal festgelegt wurde
metafield.type Der Typ des Metafelds, zum Beispiel single_line_text_field

Bestellungs-Metafeld-Aktualisierung ist ein zweiter Trigger für dieselbe Änderung. Er wird zusätzlich zur „Metafeld-Aktualisierung“ ausgelöst und überträgt die Bestellung als native Flow-Referenz, sodass die Shopify-eigenen Bestellaktionen ohne einen Nachschlagsschritt darauf angewendet werden können. Beide nutzen dasselbe Ereignis, sodass die Verwendung beider Trigger nicht doppelt gezählt wird. Aktivieren Sie ihn auf der Seite Trigger der App oder schalten Sie einen Workflow ein, der ihn nutzt.

3. Erstellen Sie den Workflow

  1. Erstellen Sie in Shopify Flow einen Workflow und wählen Sie den Trigger Metafeld-Aktualisierung aus den Workflow Trigger Extensions aus.
  2. Fügen Sie eine Bedingung hinzu: resourceType ist gleich ORDER. Die Aktualisierung der Metafelder wird für jeden von Ihnen erfassten Ressourcentyp gestartet; diese Bedingung beschränkt den Workflow daher auf Bestellungen. Wenn Sie mehrere Metafelder dieses Typs erfassen, fügen Sie als zweites Kriterium hinzu: metafieldKey ist gleich custom.gift_message.
  3. Fügen Sie die gewünschte Aktion hinzu. Im Beispiel wird eine interne E-Mail mit dem alten und dem neuen Wert versendet.
Der Beispiel-Workflow in Shopify Flow: „Metafeld aktualisieren“, eine Bedingung für den Ressourcentyp „ORDER“ und „Interne E-Mail senden“
Der Beispiel-Workflow: der Trigger, die Bedingung für den Ressourcentyp und eine Aktion.

Beginnen Sie mit dem Beispiel

  1. Laden Sie die am Ende dieser Seite angehängte .flow-Datei herunter.
  2. Öffnen Sie in Ihrem Shopify-Adminbereich Shopify Flow, klicken Sie auf Importieren und wählen Sie die Datei aus.
  3. Öffnen Sie den Schritt Interne E-Mail senden und geben Sie den Empfänger ein. Die Datei enthält bewusst keine Adresse.
  4. Aktivieren Sie den Workflow.

Machen Sie es zu Ihrem eigenen

  • Bestellung kennzeichnen: Fügen Sie die Aktion Bestellkennzeichnungen hinzufügen hinzu und geben Sie {{resourceId}} in das entsprechende Feld ein.
  • Fügen Sie die Bedingung „metafield.value ist nicht leer“ hinzu, damit bei einer gelöschten Nachricht keine Daten gesendet werden.
  • Verwenden Sie Auftragsmetafeld aktualisieren, wenn der Workflow Artikel oder die Lieferadresse auslesen soll.

Wie schnell es reagiert

Shopify benachrichtigt die App, sobald eine Bestellung gespeichert wird, sodass der Workflow in der Regel innerhalb weniger Sekunden beginnt.

Gut zu wissen

  • Standardmäßig überwacht die App Bestellungen, die in den letzten 60 Tagen erstellt wurden. Für ältere Bestellungen ist der Zugriff auf den vollständigen Bestellverlauf auf der Seite „Berechtigungen“ sowie ein längerer Zeitraum in den Einstellungen für den Bestellverlauf der App erforderlich.

Mehr