> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livyapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mit Shopify Flow automatisieren

Shopify Flow ist die Automatisierungs-App von Shopify: Damit baust du Regeln nach dem Muster "wenn das passiert, mach jenes", ohne Code zu schreiben. Livy verbindet sich mit Flow und steuert zwei Bausteine bei: einen **Schritt**, um Punkte anzupassen (Adjust Livy points), und einen **Auslöser**, der meldet, wenn Livy Punkte gutschreibt (Livy points awarded).

Damit kannst du Kundinnen und Kunden belohnen, die du als VIP markierst, Punkte abziehen, wenn eine Bestellung zurückgegeben wird, oder dein Team in Slack benachrichtigen, sobald jemand Punkte sammelt.

## Bevor du anfängst

* Dein Livy-Tarif muss **Starter oder höher** sein. Der Free-Tarif enthält diese Integration nicht.
* Du brauchst die App **Shopify Flow**. Sie ist kostenlos und kommt von Shopify.

<Note>
  In Livy siehst du den Status dieser Integration unter **Konfigurationen > Shopify Flow**.
</Note>

## Der Schritt: Adjust Livy points

Du fügst ihn als Aktion in einen beliebigen Workflow ein. Er addiert oder subtrahiert Punkte einer Kundin oder eines Kunden.

| Feld       | Was es ist                                                               |
| ---------- | ------------------------------------------------------------------------ |
| **Kunde**  | Wessen Punkte angepasst werden.                                          |
| **Points** | Ganze Zahl ungleich null. Positiv addiert, negativ subtrahiert.          |
| **Reason** | Optional, bis zu 400 Zeichen. Wird in der Punktetransaktion gespeichert. |

### Das Vorzeichen entscheidet

Eine **positive** Zahl addiert. Eine **negative** subtrahiert. Die `0` wird abgelehnt, denn eine Anpassung um null Punkte ist keine Anpassung.

<Warning>
  **Reicht das Guthaben nicht aus, ziehen wir ab, so weit es reicht, und der Workflow gilt trotzdem als erfolgreich.** Wenn du 500 abziehen willst und die Person hat 100, werden diese 100 abgezogen und der Stand landet bei null: Es entstehen keine Minuspunkte und Flow markiert den Schritt nicht als fehlgeschlagen.

  Das ist Absicht. Der Normalfall eines Abzugs ist eine Rückgabe, und dann hat die Kundin die Punkte oft längst ausgegeben. Ein Fehlschlag käme genau dann, wenn du am ehesten abziehen willst.
</Warning>

## Der Auslöser: Livy points awarded

Damit startest du einen Workflow. Er wird ausgelöst, wenn Livy Punkte gutschreibt.

| Feld               | Was es liefert                                                              |
| ------------------ | --------------------------------------------------------------------------- |
| **Kunde**          | Wer die Punkte bekommen hat.                                                |
| **Points awarded** | Wie viele Punkte vergeben wurden.                                           |
| **Points balance** | Der Punktestand nach der Gutschrift.                                        |
| **Source**         | `order` bei einem Kauf, `earn_rule` bei einer Verdienstregel.               |
| **Rule**           | Die Regelart, die sie vergeben hat. Leer, wenn `Source` gleich `order` ist. |

<Note>
  Die Feldnamen stehen auf Englisch, weil Shopify sie nicht übersetzt: Genau so siehst du sie in der Variablenauswahl im Flow-Editor.
</Note>

### Wann er NICHT ausgelöst wird

* Wenn du Punkte im Livy-Adminbereich von Hand anpasst.
* Wenn du deine Kunden- oder Bestellhistorie importierst.
* Wenn die Punkte aus dem Flow-Schritt selbst kommen.

<Warning>
  Der letzte Punkt ist der wichtigste: Ohne diese Regel würde ein Workflow, der Punkte vergibt, sich selbst in einer Schleife auslösen.
</Warning>

## Beispiele

### Eine VIP-Kundin belohnen

<Steps>
  <Step title="Auslöser: Customer tags added (von Shopify)" />

  <Step title="Bedingung: Das Tag lautet VIP" />

  <Step title="Aktion: Adjust Livy points, Points auf 500 und Reason 'VIP-Kundin'" />
</Steps>

### Punkte bei einer Rückgabe abziehen

<Steps>
  <Step title="Auslöser: Order refunded (von Shopify)" />

  <Step title="Aktion: Adjust Livy points, Points auf -200 und Reason 'Bestellung zurückgegeben'" />
</Steps>

Dieser Fall ist der Grund, warum der Schritt anpasst und nicht nur gutschreibt.

### Das Team benachrichtigen, wenn jemand über eine Regel Punkte sammelt

<Steps>
  <Step title="Auslöser: Livy points awarded" />

  <Step title="Bedingung: Source ist gleich earn_rule" />

  <Step title="Aktion: Send Slack message, mit Points awarded und Rule im Text" />
</Steps>

## Wenn etwas schiefgeht

Flow zeigt dir den Grund im Verlauf des Workflows. Das sind die Meldungen, die Livy zurückgeben kann.

<Note>
  **Die Meldungen sind auf Englisch**, genau so kopiert, wie Flow sie anzeigt, damit du hier nach der Meldung suchen kannst, die du siehst. Daneben steht, was zu tun ist.
</Note>

| Meldung                                                                                        | Was zu tun ist                                                     |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| Your current plan does not include the Shopify Flow integration. Upgrade to Starter or higher. | Tarif wechseln unter **Konfigurationen > Abonnement und Nutzung**. |
| Your Livy subscription is not active. Check the plan in the app to resume it.                  | Dein Abo ist pausiert oder gekündigt. Setze es in der App fort.    |
| Your loyalty program is paused in Livy.                                                        | Schalte dein Programm in Livy wieder ein.                          |
| You reached the order limit of your plan for this month.                                       | Warte auf die nächste Periode oder erweitere deinen Tarif.         |
| Points must be a whole number other than zero. Positive adds, negative subtracts.              | Korrigiere das Feld **Points** im Schritt.                         |
| The reason cannot be longer than 400 characters.                                               | Kürze das Feld **Reason**.                                         |
| That customer has no email in Shopify, and Livy needs one to track their points.               | Hinterlege für diese Person eine E-Mail in Shopify.                |
| We could not find that customer in Shopify.                                                    | Die Person wurde gelöscht. Prüfe den Auslöser des Workflows.       |
| The step did not receive a customer. Check that the workflow trigger delivers one.             | Dein Auslöser liefert keinen Kunden. Nimm einen, der das tut.      |
| We could not find your store in Livy. Reinstall the app and try again.                         | Installiere Livy neu.                                              |
| Livy is uninstalled on this store.                                                             | Installiere Livy erneut.                                           |

### Der Schritt wiederholt sich von selbst

Ist das Problem vorübergehend (Livy antwortet kurz nicht), wiederholt Flow den Schritt stundenlang, ohne dass du etwas tun musst. Die Meldungen in der Tabelle oben lösen sich **nicht** von selbst: Dort bricht Flow ab und zeigt sie dir.

### Ein erneuter Durchlauf verdoppelt die Punkte nicht

Jeder Durchlauf hat seine eigene Kennung. Wiederholt Flow denselben, erkennt Livy das und passt nicht noch einmal an.

***

#### <Icon icon="message-lines" />  Livy gestalten wir alle gemeinsam.

Zögere nicht, uns zu schreiben, wenn du Hilfe brauchst oder einen Vorschlag hast. Du kannst uns unter [info@livyapps.com](mailto:info@livyapps.com) erreichen. Wir sind für dich da.
