# Automatisierungen

> Automatisierungen führen Schritte aus, etwa eine E-Mail senden, warten oder einen Kontakt aktualisieren, wenn ein Trigger auslöst. Kontexte, Status, Durchläufe, Credits und die API.

Eine Automatisierung ist ein Workflow, der von selbst startet: Wenn ein Trigger auslöst, etwa weil ein Kontakt einer Kontaktliste hinzugefügt wird oder eine E-Mail bounct, startet Emailit einen Durchlauf, der die verbundenen Schritte abarbeitet, zum Beispiel eine E-Mail senden, einen Tag warten oder den Kontakt aktualisieren. Nutzen Sie Automatisierungen für Willkommens-E-Mails, Onboarding-Sequenzen, Geburtstags-E-Mails, Weiterleitungen und Benachrichtigungen.

> **Automatisierungen sind in der Beta:** Automatisierungen funktionieren in jedem Workspace, aber einige Optionen sind noch nicht fertig. Wo sich Weboberfläche und API unterscheiden, weisen diese Seiten darauf hin.

## So funktioniert es

1. **Ein Trigger löst aus.** Jede Automatisierung beginnt mit genau einem Trigger, zum Beispiel **Added to audience**. Optionale Filter schränken ihn ein.
2. **Emailit startet einen Durchlauf** für den Kontakt oder die E-Mail, die ihn ausgelöst hat, und berechnet 3 Credits.
3. **Der Durchlauf arbeitet die Schritte ab**, die mit dem Trigger verbunden sind, einen nach dem anderen. Schritte vom Typ **Wait** pausieren den Durchlauf, Schritte vom Typ **Condition** leiten ihn in den Zweig **Yes** oder **No**.
4. **Der Durchlauf endet**, wenn er den letzten Schritt seines Zweigs erreicht, oder schlägt fehl, wenn ein Schritt fehlschlägt.

Sie bauen den Ablauf auf einer Arbeitsfläche in der Weboberfläche auf oder senden ihn als Liste von Schritten und Verbindungen an die API. Siehe [Trigger](/de/docs/automations/triggers/) und [Schritte](/de/docs/automations/steps/).

## Kontexte

Jede Automatisierung hat einen Kontext. Er legt fest, worum es in einem Durchlauf geht und welche Trigger und Schritte verfügbar sind. Sie wählen ihn beim Erstellen der Automatisierung, danach lässt er sich nicht mehr ändern.

| Kontext | Label | Jeder Durchlauf betrifft | Geeignet für | Trigger |
| --- | --- | --- | --- | --- |
| **Contact** | Easy | Einen Kontakt | Willkommensserien, Onboarding, Reaktivierung | Mitgliedschaft in Kontaktlisten, Kontaktänderungen, Jahrestage von Datumsfeldern |
| **Email** | Medium | Eine E-Mail | Antwort-Handler, automatische Weiterleitungen, Bounce-Benachrichtigungen | E-Mail-Events wie zugestellt, gebounct oder empfangen |
| **Event** | Advanced | Einen API-Aufruf | API-gesteuerte Abläufe, eigene Integrationen | Ein manueller Trigger, den Sie per API aufrufen |

In der Weboberfläche trägt der Kontext **Event** das Badge **Soon** und lässt sich noch nicht auswählen. Event-Automatisierungen können Sie per API erstellen.

## Automatisierung erstellen

1. **Beginnen.** Öffnen Sie **Email Marketing → Automations** und wählen Sie **New automation**.

2. **Kontext wählen.** Wählen Sie **Contact** oder **Email**.

3. **Vorlage wählen.** Wählen Sie eines der [fertigen Rezepte](/de/docs/automations/recipes/) oder **Start from scratch** für eine leere Arbeitsfläche, die nur einen Trigger enthält.

4. **Benennen.** Geben Sie einen **Name** und optional eine **Description** ein und wählen Sie dann **Create**. Die Automatisierung öffnet sich als Entwurf.

5. **Ablauf aufbauen.** Wählen Sie im Tab **Editor** den Trigger und jeden Schritt aus, um sie zu konfigurieren, und fügen Sie mit den Plus-Schaltflächen Schritte hinzu. Wählen Sie **Save**.

6. **Automatisierung starten.** Wählen Sie **Start**. Ab jetzt startet jeder passende Trigger einen Durchlauf.

Die Listenseite hat Tabs für Automatisierungen der Kontexte **Contact**, **Email** und **Event** und zeigt für jede **Name**, **Status**, den Zeitpunkt **Last triggered** und das Datum **Created**.

## Status

| Status | Trigger starten Durchläufe | In der Weboberfläche bearbeitbar | So gelangt sie dorthin |
| --- | --- | --- | --- |
| **Draft** | Nein | Ja | Jede neue Automatisierung beginnt als Entwurf. |
| **Running** | Ja | Nein | Einen Entwurf oder eine pausierte Automatisierung mit **Start** starten. |
| **Paused** | Nein | Ja | Eine laufende Automatisierung mit **Pause** pausieren. **Start** setzt sie fort. |
| **Stopped** | Nein | Nein | Nur über den Endpunkt [stop](/de/docs/api-reference/automations/stop/) der API, der auch alle laufenden Durchläufe abbricht. |

Pausieren verhindert, dass neue Durchläufe starten, aber bereits laufende Durchläufe gehen weiter, auch solche, die in einem Schritt **Wait** warten. **Delete** im Menü oben in der Automatisierung entfernt sie in jedem Status.

### Regeln für die Bearbeitung

Der Tab **Editor** ist nur verfügbar, solange die Automatisierung ein Entwurf oder pausiert ist. Bei einer laufenden Automatisierung zeigt der Tab **Pause to edit**.

**Save** prüft den gesamten Ablauf und hebt die Schritte hervor, die Aufmerksamkeit brauchen, zum Beispiel einen Schritt **Send email** ohne Vorlage oder eine Wartezeit von mehr als 30 Tagen. Beheben Sie diese Probleme und speichern Sie erneut, bevor Sie **Start** wählen: Beim Starten laufen die Prüfungen nicht noch einmal.

## Durchläufe

Ein Durchlauf ist ein Durchgang durch die Automatisierung für einen Kontakt, eine E-Mail oder einen API-Aufruf. Jeder Durchlauf hat einen Status:

| Status des Durchlaufs | Bedeutung |
| --- | --- |
| **Running** | Der Durchlauf arbeitet seine Schritte ab oder wartet. |
| **Completed** | Alle Schritte auf dem Pfad des Durchlaufs sind abgeschlossen. |
| **Failed** | Ein Schritt ist fehlgeschlagen, oder der Workspace hatte beim Start des Durchlaufs nicht genug Credits. |
| **Canceled** | Die Automatisierung wurde per API gestoppt, während der Durchlauf lief. |

Standardmäßig startet jeder Trigger einen neuen Durchlauf, auch wenn für denselben Kontakt oder dieselbe E-Mail bereits einer läuft. Dasselbe Event startet nie zwei Durchläufe derselben Automatisierung. Den Verlauf der Durchläufe und die Fehlersuche beschreibt [Durchläufe und Statistiken](/de/docs/automations/runs/).

## Credits

| Aktion | Credits |
| --- | --- |
| Jeder Durchlauf | 3, berechnet beim Start des Durchlaufs |
| Jede E-Mail, die ein Schritt **Send email** sendet | 1 |
| Jede E-Mail, die ein Schritt **Forward email** sendet | 1 |

Hat der Workspace beim Auslösen eines Triggers keine 3 Credits, wird der Durchlauf mit dem Status **Failed** und dem Grund `insufficient_credits` in seinem `meta` angelegt. Gehen die Credits mitten in einem Durchlauf aus, schlägt der Schritt **Send email** oder **Forward email** fehl. Siehe [Credits](/de/docs/billing/credits/).

## Per API nutzen

Die [Automatisierungs-API](/de/docs/api-reference/automations/) verwaltet Automatisierungen und liest ihre Durchläufe. Sie benötigt einen API-Schlüssel mit **Full Access**.

| Endpunkt | Verwendung |
| --- | --- |
| [Erstellen](/de/docs/api-reference/automations/create/), [aktualisieren](/de/docs/api-reference/automations/update/), [abrufen](/de/docs/api-reference/automations/get/), [auflisten](/de/docs/api-reference/automations/list/) und [löschen](/de/docs/api-reference/automations/delete/) | Automatisierungen verwalten. Schritte und Verbindungen werden zusammen gesendet. |
| [Starten](/de/docs/api-reference/automations/start/), [pausieren](/de/docs/api-reference/automations/pause/) und [stoppen](/de/docs/api-reference/automations/stop/) | Den Status ändern. |
| [Durchlauf auslösen](/de/docs/api-reference/automations/trigger/) | Einen Trigger **Manual** auslösen, optional mit `payload`. Die Automatisierung muss laufen. Das ist nur per API möglich. |
| [Durchläufe auflisten](/de/docs/api-reference/automations/runs/), [Durchlauf abrufen](/de/docs/api-reference/automations/run/), [Statistiken](/de/docs/api-reference/automations/stats/) und [Schrittstatistiken](/de/docs/api-reference/automations/step-stats/) | Den Verlauf der Durchläufe und die Ergebnisse pro Schritt lesen. |

Die API akzeptiert außerdem Einstellungen in `settings`, die die Weboberfläche noch nicht anzeigt:

| Einstellung | Standardwert | Wirkung |
| --- | --- | --- |
| `allow_reentry` | `true` | Auf `false` setzen, um neue Durchläufe für einen Kontakt oder eine E-Mail zu überspringen, für die bereits ein Durchlauf läuft. |
| `max_concurrent_runs` | `0` (kein Limit) | Neue Durchläufe überspringen, solange so viele Durchläufe laufen. |
| `cooldown_seconds` | `0` | Neue Durchläufe für einen Kontakt oder eine E-Mail überspringen, für die innerhalb dieser Anzahl Sekunden ein Durchlauf gestartet wurde. |
| `on_step_failure` | `stop` | `stop` lässt den Durchlauf fehlschlagen, wenn ein Schritt fehlschlägt. `skip` lässt den Durchlauf weiterlaufen. |

Übersprungene Durchläufe werden nicht angelegt und verbrauchen keine Credits.

```bash
curl https://api.emailit.com/v2/automations \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "contact",
    "name": "Welcome email",
    "settings": { "allow_reentry": false },
    "steps": [
      { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
      { "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
    ],
    "connections": [
      { "from": "trigger-1", "to": "send_email-1", "branch": "default" }
    ]
  }'
```

Die Automatisierung wird als Entwurf angelegt. Rufen Sie [Automatisierung starten](/de/docs/api-reference/automations/start/) auf, um sie zu aktivieren.

## Nächste Schritte

  - [Trigger](/de/docs/automations/triggers/): Alle Trigger und ihre Optionen.
  - [Schritte](/de/docs/automations/steps/): Alle Schritte, ihre Einstellungen und wie Verzweigungen funktionieren.
  - [Rezepte](/de/docs/automations/recipes/): Die sechs fertigen Vorlagen.
  - [Durchläufe und Statistiken](/de/docs/automations/runs/): Durchläufe verfolgen und Fehler debuggen.

---
Quelle: https://emailit.com/de/docs/automations/