Metafeld-Trigger für den Bestellentwurf

Metafeld-Trigger für den Bestellentwurf

Seite kopieren

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

Ein Vertriebsteam arbeitet mit Angeboten als Bestellentwürfen und hält den Status im Metafeld Angebotsstatus (custom.quote_status) des Bestellentwurfs fest. Wenn ein Angebot den Status approved erhält, sollte die für die Rechnungsstellung zuständige Person darüber informiert werden.

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 eines Bestellentwurfs ändert. Die Schritte sind für jedes Metafeld dieses Ressourcentyps identisch; im Beispiel wird der Angebotsstatus (custom.quote_status) verwendet.

Was Sie benötigen

  • Eine Metafeld-Definition. Erstellen Sie diese in Ihrem Shopify-Adminbereich unter Einstellungen > Metafelder und Metaobjekte > Bestellentwürfe. Ein Metafeld ohne Definition kann nicht nachverfolgt werden.
  • Die Berechtigung Bestellentwurf - 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 Bestellentwurf aus.
  3. Aktivieren Sie das Metafeld Angebotsstatus. 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 „Bestellentwurf“ und dem Metafeld „Angebotsstatus“ (custom.quote_status), das angekreuzt ist
Ressourcentyp „Bestellentwurf“, 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 Bestellentwürfen ausliest, und wechselt anschließend zu Aktiv. Aufgrund dieses ersten Lesevorgangs wird bereits bei der allerersten Änderung der richtige Vorwert übernommen.

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 erhält

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

Variable Wert
resourceType DRAFTORDER
resourceId Die ID des Bestellentwurfs, zum Beispiel gid://shopify/DraftOrder/1234567890
metafieldKey Namensraum und Schlüssel, hier custom.quote_status
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

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 DRAFTORDER. Die Aktualisierung der Metafelder wird für jeden von Ihnen erfassten Ressourcentyp gestartet; daher beschränkt diese Bedingung den Workflow auf Bestellentwürfe. Wenn Sie mehrere Metafelder dieses Typs erfassen, fügen Sie als zweites Kriterium hinzu: metafieldKey ist gleich custom.quote_status.
  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: Aktualisierung eines Metafelds, eine Bedingung für den Ressourcentyp „DRAFTORDER“ und das Versenden einer internen E-Mail
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

  • Fügen Sie eine Bedingung für metafield.value hinzu, um ausschließlich auf approved zu reagieren.
  • Den Bestellentwurf kennzeichnen: Fügen Sie die Aktion Bestellentwurf-Tags hinzufügen hinzu und tragen Sie {{resourceId}} in das Feld „Bestellentwurf-Bestellnummer“ ein.
  • Senden Sie die Änderung mit HTTP-Anfrage senden an Ihr CRM.

Wie schnell es reagiert

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

Mehr