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

# Amazon SES

> Amazon SES als E-Mail-Anbieter in Notifuse einrichten.

Notifuse kann E-Mails über AWS Simple Email Service (SES) versenden.

## Konfiguration

Öffnen Sie **Einstellungen** → **Integrationen**, klicken Sie auf **Integration hinzufügen** und wählen Sie unter **E-Mail-Versand** den Eintrag **Amazon SES**. Das Formular öffnet sich als eigene Seite.

![Formular der Amazon-SES-Integration](https://www.notifuse.com/docs/assets/screenshots/ses_form.png)

![Einstellungen von Amazon SES](https://www.notifuse.com/docs/assets/screenshots/ses_settings.png)

### Formularfelder

| Feld                           | Beschreibung                                                                                                                                  | Beispiel                                   |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **Region**                     | AWS-Region, in der Ihre verifizierten Identitäten liegen                                                                                      | `us-east-1`                                |
| **Zugriffsschlüssel-ID**       | Zugriffsschlüssel eines IAM-Benutzers, der über SES senden darf                                                                               | `AKIAIOSFODNN7EXAMPLE`                     |
| **Geheimer Zugriffsschlüssel** | Der geheime Zugriffsschlüssel dieses IAM-Benutzers                                                                                            | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` |
| **Mandantenisolierung**        | Optional. Gibt dieser Integration ein eigenes Reputationsprofil und eine eigene Sperrliste (siehe [unten](#reputation-isolation-ses-tenants)) | Aus                                        |
| **Konfigurationssatz**         | Optional, unter **Erweitert**. Über einen Konfigurationssatz senden, den Sie selbst verwalten                                                 | `my-config-set`                            |
| **SES-Mandant**                | Optional, unter **Erweitert**. Über einen Mandanten senden, den Sie selbst verwalten                                                          | `my-tenant`                                |

### Absenderliste

Fügen Sie Absenderadressen hinzu, die in Ihren AWS-SES-Einstellungen verifiziert sind:

| Feld       | Beschreibung                 | Beispiel                 |
| ---------- | ---------------------------- | ------------------------ |
| **Name**   | Anzeigename des Absenders    | `Support Team`           |
| **E-Mail** | E-Mail-Adresse des Absenders | `support@yourdomain.com` |

Absender müssen in der AWS-SES-Konsole verifiziert sein, bevor Sie sie verwenden können.

### Verwendungsarten

Was diese Amazon-SES-Integration versendet, legen Sie im Menü **⋯** ihrer Karte unter **Einstellungen** → **Integrationen** fest (**Für Marketing verwenden**, **Für Transaktionales verwenden**) oder im Bereich **E-Mail-Versand** derselben Seite:

| Option                            | Beschreibung                                                       | Beispiele                                                                   |
| --------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| **Für Transaktionales verwenden** | Vom System erzeugte E-Mails, ausgelöst durch Aktionen der Benutzer | Zurücksetzen von Passwörtern, Bestellbestätigungen, Kontobenachrichtigungen |
| **Für Marketing verwenden**       | Werbe- und Newsletter-E-Mails an Abonnenten                        | Produktankündigungen, Newsletter, Werbekampagnen                            |

Wählen Sie beides, um alle Arten von E-Mails über dieselbe SES-Konfiguration zu senden.

### Webhooks

Notifuse abonniert automatisch die folgenden SES-Webhooks:

| Webhook-Typ     | Beschreibung                                 | Zweck                               |
| --------------- | -------------------------------------------- | ----------------------------------- |
| **Zustellung**  | E-Mail erfolgreich zugestellt                | Erfolgreiche Zustellungen verfolgen |
| **Rückläufer**  | E-Mail wurde zurückgewiesen                  | Bounces überwachen                  |
| **Beschwerden** | Empfänger hat sich über Missbrauch beschwert | Missbrauchsmeldungen bearbeiten     |

Notifuse erhält diese Zustellereignisse, sobald sie eintreten.

## Reputationsisolierung (SES-Mandanten)

Standardmäßig teilen sich alle Arbeitsbereiche eines AWS-Kontos eine Absenderreputation und **eine Sperrliste**. Eine schlecht ausgerichtete Kampagne eines Teams kann die Bounce- oder Beschwerderate des Kontos über die Schwellenwerte von AWS treiben und den Versand für alle pausieren. Ein Hard Bounce in einem Arbeitsbereich sperrt den Empfänger außerdem in allen anderen.

**Mandantenisolierung** gibt einer Integration einen eigenen [SES-Mandanten](https://docs.aws.amazon.com/ses/latest/dg/tenants.html) mit eigenem Reputationsprofil, eigenen Kennzahlen für Bounces und Beschwerden und eigener Sperrliste. AWS kann dann einen einzelnen Mandanten pausieren statt des ganzen Kontos.

> [!NOTE]
>
> **Selbst gehostet: Um einen neuen SES-Mandanten einzurichten, brauchen Sie einen [Lizenzschlüssel](https://www.notifuse.com/de/docs/self-hosting/licence.md).** Ein bereits eingerichteter Mandant sendet auch ohne Lizenzschlüssel dauerhaft über seine eigene Reputation weiter, denn der Versandweg enthält keine Lizenzprüfung. Notifuse Cloud enthält die SES-Mandantenisolierung ab dem Starter-Plan ([Details](https://www.notifuse.com/de/docs/self-hosting/licence.md#on-notifuse-cloud)).

### Aktivieren

Öffnen Sie die Integration (**Einstellungen** → **Integrationen**), schalten Sie im Bereich **Reputation** die **Mandantenisolierung** ein und speichern Sie. Notifuse bittet Sie um Bestätigung, weil ein Mandant eine kostenpflichtige AWS-Ressource ist, und richtet dann alles in Ihrem Konto ein:

| Schritt                           | Was Notifuse tut                                                                                                                  |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Mandant erstellen**             | Name `notifuse-<integration ID>`, mit `SuppressionScope: TENANT` für Bounces und Beschwerden                                      |
| **Konfigurationssatz verknüpfen** | Verknüpft den Konfigurationssatz, über den diese Integration sendet                                                               |
| **Identitäten verknüpfen**        | Verknüpft jede verifizierte Identität, die einen Absender abdeckt: die genaue Adresse, ihre Domain oder eine übergeordnete Domain |

Wenn Sie erneut speichern, laufen dieselben Schritte noch einmal. So wird ein später hinzugefügter Absender verknüpft, und so wird ein unvollständiger Durchlauf wiederholt.

> [!NOTE]
>
> **Eine Sperrliste pro Mandant ist bei AWS nicht die Voreinstellung.** Ein Mandant, den Sie von Hand in der SES-Konsole anlegen, übernimmt die Sperrliste des Kontos, solange Sie den Geltungsbereich der Sperrliste nicht selbst festlegen. Sie bekommen dann ohne jede Warnung eine eigene Reputation, aber _keine_ eigene Sperrliste. Notifuse legt den Geltungsbereich bei der Erstellung fest und korrigiert ihn, wenn bereits ein Mandant mit diesem Namen existiert.

> [!NOTE]
>
> Die Isolierung gilt pro **Integration**, nicht pro Arbeitsbereich. Ein Arbeitsbereich mit getrennten SES-Integrationen für Marketing und Transaktionales erhält zwei Mandanten mit je eigener Sperrliste: Ein Bounce, den der eine erfasst, wird beim anderen von SES nicht gesperrt. Die eigene Sperrung von Notifuse pro Arbeitsbereich gilt trotzdem für beide, sodass schlimmstenfalls eine zusätzliche Nachricht an eine Adresse geht, die SES bereits als ungültig kennt.

### Was Sie sehen

- **Ein Absender ohne verifizierte Identität** wird nach dem Speichern mit Namen gemeldet. Beheben Sie das, denn E-Mails dieses Absenders würden mit wie ohne Mandanten fehlschlagen.
- **Eine fehlende IAM-Berechtigung** wird mit der genauen Aktion und einem `aws`-CLI-Befehl zum Ausführen gemeldet. Notifuse stellt die Integration erst auf den Mandanten um, wenn ihr Konfigurationssatz verknüpft ist, denn SES lehnt **jede** Nachricht ab, die ohne ihn über einen Mandanten gesendet wird. Bei einer unvollständigen Einrichtung bleibt der Versand genau so, wie er war.
- Die Karte der Integration zeigt den verwendeten Konfigurationssatz und ob die Reputation `isolated` oder `shared with the rest of this AWS account` ist.

### Deaktivieren

Wenn Sie die **Mandantenisolierung** ausschalten, gilt das ab dem nächsten Versand: Nachrichten gehen wieder unter der gemeinsamen Reputation des Kontos hinaus. Der Mandant bleibt mit seiner Sperrliste und seinem Reputationsverlauf in AWS bestehen, und wenn Sie sie wieder einschalten, wird derselbe Mandant weiterverwendet.

> [!NOTE]
>
> Ein Mandant, für den die Isolierung ausgeschaltet wurde, **wird weiter abgerechnet**, bis die Integration gelöscht wird. Schalten Sie die Isolierung aus, um die Art des Versands zu ändern, und löschen Sie die Integration, um die Kosten zu beenden.

> [!WARNING]
>
> **Wenn Sie die Integration löschen, wird der Mandant gelöscht**, zusammen mit seiner Sperrliste und seinem Reputationsverlauf, die sich nicht wiederherstellen lassen. Entfernen Sie nur die Webhooks, bleiben beide erhalten, weil der Versand weiterhin von ihnen abhängt.

### Erweitert: eigener Mandant oder eigener Konfigurationssatz

Unter **Erweitert** sind beide Felder optional und schlagen die Namen vor, die es in Ihrem Konto gibt (können Ihre Zugangsdaten sie nicht auflisten, bleiben es einfache Textfelder):

| Feld                   | Beschreibung                                                                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Konfigurationssatz** | Über einen Konfigurationssatz senden, den Sie selbst verwalten, statt über `notifuse-<integration ID>`. Notifuse hängt sein Ereignisziel daran an, erstellt oder löscht ihn aber nie. |
| **SES-Mandant**        | Über einen Mandanten senden, den Sie selbst verwalten. Lässt sich nicht mit dem Schalter oben kombinieren. Notifuse erstellt, ändert oder löscht ihn nicht.                           |

Mit einem eigenen Mandanten müssen Sie die sendende Identität **und** den Konfigurationssatz selbst mit ihm verknüpfen, sonst lehnt SES jeden Versand ab:

```bash
aws sesv2 create-tenant-resource-association \
  --tenant-name my-tenant \
  --resource-arn arn:aws:ses:<region>:<account>:configuration-set/<name>
```

> [!NOTE]
>
> Mandanten gibt es nur in der SES API v2, über die Notifuse jetzt sendet. Sie sind außerdem an eine Region gebunden: Ein Mandant liegt in derselben Region wie seine Integration.

## Eingehende Antworten (Stopp bei Antwort)

Für **[Bei Antwort verlassen](https://www.notifuse.com/de/docs/features/automations.md#exit-on-reply)** in Automatisierungen muss SES eingehende Antworten an Notifuse weiterleiten. SES behandelt den E-Mail-Empfang getrennt vom Versand. Sie richten ihn einmalig in zwei Schritten ein:

1. **Richten Sie die MX-Records Ihrer Domain auf SES aus.** Legen Sie auf Ihrer Absenderdomain einen MX-Record mit Priorität `10` an, der auf den SES-Eingangsendpunkt Ihrer Region zeigt, `inbound-smtp.<region>.amazonaws.com` (zum Beispiel `inbound-smtp.us-east-1.amazonaws.com`). Ohne ihn erreichen Antworten SES nie. SES hat keine DNS-API, daher erledigen Sie das von Hand.
2. **Registrieren Sie die Eingangsroute.** Öffnen Sie unter **Einstellungen → Integrationen** das Menü **⋯** der SES-Integration und wählen Sie **Webhooks erneut registrieren** (**Webhooks registrieren**, falls sie noch nicht registriert sind). Zusätzlich zu den Ereignis-Webhooks für Zustellungen, Bounces und Beschwerden richtet Notifuse ein SNS-Topic ein (per HTTPS bei Notifuse abonniert, mit SignatureVersion 2 signiert) sowie eine SES-**Empfangsregel** mit einer SNS-Aktion. Hat Ihr Konto einen aktiven Empfangsregelsatz, wird die Regel **in diesen** eingefügt. Sie leitet nur eine Kopie weiter und hat keine _Stop_-Aktion, sodass eine bestehende Einrichtung (etwa Amazon WorkMail) weiter funktioniert. Einen eigenen Regelsatz `notifuse-inbound` erstellt und aktiviert Notifuse **nur**, wenn kein Regelsatz aktiv ist.

> [!NOTE]
>
> Den E-Mail-Empfang von SES gibt es nur in einigen AWS-Regionen (zum Beispiel `us-east-1`, `us-west-2`, `eu-west-1`). Unterstützt die Region Ihrer Integration ihn nicht, meldet die Eingangsregistrierung ihn als nicht verfügbar. Siehe die AWS-Liste der [Endpunkte für den E-Mail-Empfang](https://docs.aws.amazon.com/general/latest/gr/ses.html).
>
> Das SNS-Topic für eingehende E-Mails, die Empfangsregel und das Abonnement brauchen IAM-Berechtigungen, die über den Versand hinausgehen: `sns:CreateTopic`, `sns:SetTopicAttributes`, `sns:Subscribe`, `ses:DescribeActiveReceiptRuleSet`, `ses:CreateReceiptRuleSet`, `ses:CreateReceiptRule`, `ses:SetActiveReceiptRuleSet`, `ses:DeleteReceiptRule` und `ses:ListIdentities`. Die Empfangsregel erfasst nur die verifizierten Identitäten Ihres Kontos (Domains und E-Mail-Adressen). Ist keine verifiziert, wird die Eingangsregistrierung verweigert, damit die Regel nie alle E-Mails des Kontos weiterleitet.
>
> Antworten werden dem ursprünglichen Versand über ihre `Message-ID` zugeordnet. SES überschreibt diesen Header beim Versand. Notifuse speichert deshalb den Wert, den SES zurückgibt, und ordnet ihn unabhängig vom Host zu, ohne eigenen Signaturschlüssel für eingehende E-Mails. Bevor Notifuse einer eingehenden SNS-Benachrichtigung vertraut, wird sie **per RSA-Signatur verifiziert** und **gegen das eingerichtete Topic geprüft**: Eine Nachricht von einem anderen SNS-Topic wird abgelehnt, selbst mit gültiger AWS-Signatur. Der Endpunkt hat ein Ratenlimit.

> [!WARNING]
>
> **Bei manueller Einrichtung muss die ARN des SNS-Topics hinterlegt sein.** Eingehende Nachrichten werden gegen das eingerichtete Topic authentifiziert, daher lehnt eine Integration ohne gebundene Topic-ARN alle eingehenden E-Mails ab. Wenn Sie die Webhooks über das Menü **⋯** registrieren, wird sie automatisch hinterlegt. Verbinden Sie den SES-Eingang von Hand (eigenes SNS-Topic + Empfangsregel), tragen Sie die Topic-ARN in der Einstellung `inbound_topic_arn` der SES-Integration ein, sonst werden Antworten nicht angenommen.

Sind beide Schritte erledigt, verlässt ein Kontakt, der auf eine E-Mail einer Automatisierung antwortet, die Journey, sofern bei dieser Automatisierung **Bei Antwort verlassen** aktiviert ist. Bounces und automatische Abwesenheitsnotizen zählen nie als Antwort.

## Voraussetzungen

Sie benötigen:

1. Ein aktives AWS-Konto mit aktiviertem SES
2. In der AWS-SES-Konsole verifizierte E-Mail-Adressen oder Domains
3. Einen AWS-Benutzer mit Sendeberechtigungen für SES (siehe unten)
4. Produktionszugang: Verlassen Sie die SES-Sandbox, um ohne Einschränkungen zu senden

### IAM-Berechtigungen

Nur die erste Gruppe ist erforderlich. Jede weitere Gruppe schaltet eine optionale Funktion frei, und Notifuse funktioniert auch ohne sie: Eine fehlende Berechtigung wird mit der hinzuzufügenden Aktion gemeldet und führt nie zu einem stillen Fehler.

| Zweck                           | Aktionen                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Versand** (erforderlich)      | `ses:SendEmail`                                                                                                                                                                                                                                                                                                                                    |
| **Ereignis-Webhooks**           | `ses:CreateConfigurationSet`, `ses:DescribeConfigurationSet`, `ses:ListConfigurationSets`, `ses:DeleteConfigurationSet`, `ses:CreateConfigurationSetEventDestination`, `ses:UpdateConfigurationSetEventDestination`, `ses:DeleteConfigurationSetEventDestination`, `sns:CreateTopic`, `sns:Subscribe`, `sns:GetTopicAttributes`, `sns:DeleteTopic` |
| **Reputationsisolierung**       | `ses:CreateTenant`, `ses:GetTenant`, `ses:PutTenantSuppressionAttributes`, `ses:CreateTenantResourceAssociation`, `ses:ListEmailIdentities`                                                                                                                                                                                                        |
| **Namensauswahl und Prüfungen** | `ses:ListTenants`, `ses:ListTenantResources`                                                                                                                                                                                                                                                                                                       |
| **Sauberes Entfernen**          | `ses:DeleteTenant`, `ses:DeleteTenantResourceAssociation`                                                                                                                                                                                                                                                                                          |
| **Eingehende Antworten**        | Siehe den [Hinweis zu Stopp bei Antwort](#inbound-replies-stop-on-reply) oben                                                                                                                                                                                                                                                                      |

> [!WARNING]
>
> Ohne die Berechtigungen für **sauberes Entfernen** bleibt beim Löschen einer Integration ihr Mandant in Ihrem AWS-Konto zurück und wird weiter abgerechnet, bis Sie ihn von Hand entfernen.

## Testen

Klicken Sie oben im Integrationsformular auf **Test-E-Mail senden** oder auf der Karte der Integration auf **Test senden**, um Ihre Konfiguration zu prüfen.
