> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/wieder-auf-lager-benachrichtigung/flow-builder-and-e-mail-vorlagen.md).

# Flow Builder & E-Mail Vorlagen

Das Stock Reminder Plugin integriert sich vollständig in den Shopware Flow Builder. Dadurch kannst du den E-Mail-Versand für Benachrichtigungen und Bestätigungen individuell steuern und mit bestehenden Workflows kombinieren.

### Verfügbare Events

Das Plugin stellt drei eigene Business Events bereit, die im Flow Builder als Trigger verwendet werden können:

#### `prems_stock_reminder.double_opt_in`

Dieses Event wird ausgelöst, wenn ein Besucher das Benachrichtigungsformular absendet und die Double-Opt-In-Funktion aktiviert ist. Es enthält die Daten, die für die Bestätigungs-E-Mail benötigt werden, einschließlich des Bestätigungslinks.

**Typischer Flow:** Versende eine E-Mail mit dem Bestätigungslink an den Abonnenten.

| Variable      | Beschreibung                                           |
| ------------- | ------------------------------------------------------ |
| `productName` | Name des abonnierten Produkts                          |
| `confirmUrl`  | Bestätigungslink für das Double-Opt-In                 |
| `shopName`    | Name des Shops (aus den Stammdaten des Verkaufskanals) |
| `email`       | E-Mail-Adresse des Abonnenten                          |

#### `prems_stock_reminder.back_in_stock`

Dieses Event wird ausgelöst, wenn ein Produkt wieder verfügbar ist und die Benachrichtigungs-E-Mail an den Abonnenten versendet werden soll. Es enthält die Produktdaten und die Informationen zum Abonnement.

**Typischer Flow:** Versende eine E-Mail an den Abonnenten mit den Produktinformationen und einem Link zum Produkt.

| Variable      | Beschreibung                                           |
| ------------- | ------------------------------------------------------ |
| `productName` | Name des wieder verfügbaren Produkts                   |
| `productId`   | ID des Produkts, z. B. für einen Link zum Produkt      |
| `quantity`    | Vom Abonnenten gewünschte Menge                        |
| `shopName`    | Name des Shops (aus den Stammdaten des Verkaufskanals) |
| `email`       | E-Mail-Adresse des Abonnenten                          |

> **Tipp:** Mit der Variable `productId` kannst du in der E-Mail-Vorlage einen Link zum Produkt erzeugen, z. B. über `rawUrl('frontend.detail.page', {'productId': productId}, salesChannel.domains|first.url)`.

#### `prems_stock_reminder.subscription_created`

Dieses Event wird ausgelöst, sobald sich ein Kunde neu für eine Lagerbenachrichtigung zu einem Produkt anmeldet. Damit kannst du z. B. den Shopbetreiber automatisch darüber informieren, welches Produkt abonniert wurde. Das Event wird nur beim erstmaligen Abonnement einer E-Mail-Adresse für ein Produkt ausgelöst – nicht, wenn ein bestehendes Abonnement erneut abgesendet wird.

Der Versand wird ausschließlich über den Flow Builder gesteuert: Der mitgelieferte Flow **Stock Reminder - Subscription Notification** ist nach der Installation zunächst **deaktiviert**. Um die Funktion zu nutzen, aktiviere den Flow unter **Einstellungen > Flow Builder**. Als Empfänger ist der Standard-Empfänger konfiguriert – das ist die Shopbetreiber-Adresse aus den Stammdaten des Verkaufskanals (**Stammdaten > E-Mail-Adresse**). Den Empfänger kannst du in der Flow-Aktion jederzeit anpassen.

**Typischer Flow:** Versende eine E-Mail an den Shopbetreiber mit den Informationen zum neuen Abonnement.

| Variable        | Beschreibung                                           |
| --------------- | ------------------------------------------------------ |
| `productName`   | Name des abonnierten Produkts                          |
| `productNumber` | Produktnummer des abonnierten Produkts                 |
| `productId`     | ID des Produkts, z. B. für einen Link zum Produkt      |
| `quantity`      | Vom Abonnenten gewünschte Menge                        |
| `shopName`      | Name des Shops (aus den Stammdaten des Verkaufskanals) |
| `email`         | E-Mail-Adresse des Abonnenten                          |

Zusätzlich steht bei allen Events in den E-Mail-Vorlagen das Objekt `salesChannel` mit den Daten des jeweiligen Verkaufskanals zur Verfügung.

### E-Mail-Vorlagen einrichten

Die E-Mail-Vorlagen werden bei der Installation des Plugins automatisch angelegt und im Flow Builder mit den entsprechenden Events verknüpft. Du kannst die Vorlagen jederzeit über **Einstellungen > E-Mail-Templates** anpassen.

Folgende Vorlagen und Flows liefert das Plugin mit:

| E-Mail-Vorlage (Typ)                             | Flow                                        | Event                                       | Nach Installation aktiv |
| ------------------------------------------------ | ------------------------------------------- | ------------------------------------------- | ----------------------- |
| Lagerbenachrichtigung - Double-Opt-In            | Stock Reminder - Double Opt-In Confirmation | `prems_stock_reminder.double_opt_in`        | Ja                      |
| Lagerbenachrichtigung - Wieder verfügbar         | Stock Reminder - Back in Stock Notification | `prems_stock_reminder.back_in_stock`        | Ja                      |
| Lagerbenachrichtigung - Neues Abonnement (Admin) | Stock Reminder - Subscription Notification  | `prems_stock_reminder.subscription_created` | Nein                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.premsoft.de/plugins/wieder-auf-lager-benachrichtigung/flow-builder-and-e-mail-vorlagen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.