> 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/formular-baukasten/email-versand-und-flow-builder.md).

# Email Versand und Flow Builder

Jede Einsendung kann zwei verschiedene Mails auslösen:

1. eine **interne Benachrichtigung** (per Mail-Route)
2. eine **Bestätigung an die Kund:in** (per Flow Builder Action)

## Interne Benachrichtigung — Mail-Routen

Mail-Routen verwaltest du im Formular-Editor unter **E-Mail**. Eine Route beschreibt einen einzelnen Versand-Empfänger.

### Felder einer Route

| Feld         | Bedeutung                                                                                 |
| ------------ | ----------------------------------------------------------------------------------------- |
| Route-Name   | interne Beschriftung                                                                      |
| Aktiv        | Route ein-/ausschalten                                                                    |
| Mail-Vorlage | optional; sonst wird die Standard-Vorlage „Formular-Werkzeug – Neue Einsendung" verwendet |
| Empfänger    | Haupt-Empfänger-Adresse (Pflicht)                                                         |
| CC           | optional, Komma-getrennt (Premium)                                                        |
| BCC          | optional, Komma-getrennt (Premium)                                                        |
| Bedingungen  | UND-verknüpfte Filter, z. B. „nur senden, wenn Auswahlfeld = Service" (Premium)           |

### Conditional Routing (Premium)

Im Premium-Plan kannst du beliebig viele Routen pro Formular anlegen und pro Route Bedingungen vergeben. Beispiel:

* Route 1: „Service" → an `support@`, Bedingung Auswahl = `Service`
* Route 2: „Vertrieb" → an `sales@`, Bedingung Auswahl = `Vertrieb`
* Route 3: „Alle anderen" → an `info@`, ohne Bedingung

Die Auswertung läuft pro Einsendung — passt eine Route, geht eine Mail raus; passt keine, wird nicht gesendet.

## Bestätigungs-Mail an die Kund:in

Im Reiter **Allgemein** des Formulars aktivierst du **Bestätigungs-Mail an Kunden**.

Wähle dazu:

* die **Mail-Vorlage** (Typ „Formular-Werkzeug – Bestätigung für Kunden") — Shopware liefert sie nach Plugin-Aktivierung mit
* das **Formularfeld**, das die Kunden-Adresse liefert (in der Regel das E-Mail-Feld)

Der Versand läuft als Flow-Builder-Action — du kannst sie also in eigenen Flows wiederverwenden.

## Flow Builder Integration

Beim Aktivieren des Plugins wird automatisch ein Event **Formular wurde abgesendet** im Flow Builder registriert. Daraus kannst du eigene Flows bauen — z. B.:

* eine Slack-Benachrichtigung auslösen
* einen Kunden-Tag hinzufügen
* eine externe API benachrichtigen

### Mitgelieferte Flow-Builder-Action

| Action                                             | Effekt                                                                                        |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Bestätigungs-Mail an Kunden senden (PremsForm)** | Sendet die im Formular hinterlegte Bestätigungs-Mail an die Kunden-Adresse aus der Einsendung |

Beim Installieren wird zusätzlich ein Standard-Flow eingerichtet, der diese Action automatisch beim Event „Formular wurde abgesendet" ausführt. Du kannst diesen Flow jederzeit deaktivieren oder eigene Flows ergänzen.

## Mehrsprachige Mails

Die Mail-Vorlagen sind übersetzbar wie alle Shopware-Mail-Vorlagen. Die zur Storefront passende Sprache der Einsendung wird beim Versand ausgewählt — Kund:innen erhalten also eine Bestätigung in „ihrer" Sprache.

## Variablen in Mail-Vorlagen

In den Mail-Vorlagen stehen unter anderem zur Verfügung:

* `form` — das Formular-Entity (Name, Felder, …)
* `entry` — die Einsendung (Daten, Status, Sprache, Verkaufskanal)
* `entry.data` — Liste aller übermittelten Felder mit `label`, `value` und `fieldType`

Damit baust du in der Vorlage z. B. eine vollständige Tabelle aller übermittelten Werte auf.


---

# 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:

```
GET https://docs.premsoft.de/plugins/formular-baukasten/email-versand-und-flow-builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
