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

# Listen

> Listen sind Sammlungen von Kontakten in Notifuse. Mit ihnen gruppieren Sie Ihr Publikum und versenden gezielte E-Mail-Kampagnen.

Beispiel:

```
- Newsletter Subscribers
- VIP Customers
- Event Attendees
- Product Updates
```

![Eine auf der Seite Kontakte geöffnete Liste](https://www.notifuse.com/docs/assets/screenshots/lists.png)

## Listen in der Konsole

Listen befinden sich auf der Seite **Kontakte**, in der linken Leiste unter **Listen**. Eine eigene Seite für Listen gibt es nicht. Das **+** neben **Listen** (**Neue Liste**) legt eine an.

Wenn Sie eine Liste auswählen, sehen Sie:

- **Abonnentenzahlen nach Status**: Ein Klick auf eine Zahl zeigt nur diese Kontakte. Bei abgemeldeten, zurückgewiesenen Kontakten und Beschwerden wird zusätzlich der Anteil an der Liste angezeigt.
- **Einstellungen der Liste**: Sichtbarkeit, Double Opt-in mit seiner Bestätigungsvorlage und die Listen-ID. **Liste bearbeiten** öffnet das Formular.
- **Mitglieder der Liste**, jeweils mit Status in der Liste und seit wann.

**In Liste importieren** importiert eine CSV-Datei direkt in die Liste, und das Menü **…** löscht sie.

## Kontaktstatus

Der Status eines Kontakts in einer Liste entscheidet, ob er E-Mails erhalten kann:

| Status             | E-Mail-Zustellung             | Beschreibung                                         |
| ------------------ | ----------------------------- | ---------------------------------------------------- |
| **Aktiv**          | ✅ Kann E-Mails erhalten       | Bestätigte Abonnenten, die Kampagnen erhalten können |
| **Ausstehend**     | ❌ Kann keine E-Mails erhalten | Wartet auf die Bestätigung des Double Opt-in         |
| **Abgemeldet**     | ❌ Kann keine E-Mails erhalten | Hat dem Empfang von Nachrichten widersprochen        |
| **Zurückgewiesen** | ❌ Erhält nie E-Mails          | E-Mail-Adresse ist ungültig oder nicht erreichbar    |
| **Beschwerde**     | ❌ Erhält nie E-Mails          | Hat E-Mails als Spam markiert                        |

> **Wichtig**: Kampagnen lassen die abgemeldeten Kontakte der Liste aus, es sei denn, die Kampagne setzt `exclude_unsubscribed` auf `false` (in der Konsole ist **Abgemeldete Empfänger ausschließen** ausgeschaltet), etwa für einen Sicherheits- oder Rechtshinweis. E-Mails einer solchen Kampagne haben keinen Header `List-Unsubscribe`, daher zeigen Mailprogramme keine Schaltfläche zum Abmelden. Eine API-Anfrage ohne `exclude_unsubscribed` schließt sie aus, wie die Konsole. Zurückgewiesene Kontakte und Kontakte mit Beschwerde werden unabhängig von dieser Einstellung nie angeschrieben.

Meldet sich ein Kontakt über eine E-Mail ab, die für eine Liste gesendet wurde, auf der er nicht stand (etwa eine E-Mail aus einer Automatisierung), wird er auf dieser Liste als **abgemeldet** erfasst. Eine Abmeldung ersetzt nie den Status **Zurückgewiesen** oder **Beschwerde**.

## Sichtbarkeit von Listen

### Öffentliche Listen

- **Benachrichtigungscenter**: ✅ Erscheinen im Benachrichtigungscenter
- **Zugang für Abonnenten**: Benutzer sehen diese Listen in Ihrem Benachrichtigungscenter und können sie abonnieren
- **Anwendungsfall**: Newsletter, Ankündigungen und allgemeine Mitteilungen

### Private Listen

- **Benachrichtigungscenter**: ❌ Werden Kontakten, die nicht darauf stehen, nicht angeboten. Ein Kontakt sieht eine private Liste, auf der er aktiv oder ausstehend ist, und kann sie dort nur verlassen.
- **Zugang für Abonnenten**: Nur der Arbeitsbereich fügt Kontakte hinzu, über die Konsole oder die authentifizierte API (`lists.subscribe`). Ein Kontakt kann einer privaten Liste weder über das Benachrichtigungscenter noch über den öffentlichen Endpunkt `/subscribe` beitreten und nach dem Verlassen auch nicht zurückkehren; nur der Arbeitsbereich kann ihn wieder hinzufügen. Ein Link aus seinen E-Mails erlaubt ihm nur, ein ausstehendes Double Opt-in zu bestätigen.
- **Anwendungsfall**: interne Mitteilungen, VIP-Segmente, Transaktionslisten oder einmalige Kampagnen

## Double Opt-in konfigurieren

### Double Opt-in aktivieren

Wenn Sie Double Opt-in für eine Liste aktivieren:

- **Importierte Kontakte**: Per CSV-Import oder API hinzugefügte Kontakte sind immer **„aktiv“** (sie umgehen das Double Opt-in).
- **Anonyme Abonnenten**: Benutzer, die sich über Formulare anmelden (etwa eine Newsletter-Anmeldung auf Ihrer Website), sind **„ausstehend“**.
- **Bestätigung erforderlich**: Ausstehende Kontakte müssen einen Bestätigungslink in ihrer E-Mail anklicken, um „aktiv“ zu werden.
- **Compliance**: Hilft bei der Einhaltung der DSGVO und verringert Spam-Beschwerden.

**Beispiel**: Eine Besucherin füllt auf Ihrer Website ein Newsletter-Formular aus und erhält eine Bestätigungs-E-Mail. Klickt sie auf den Link (der das Benachrichtigungscenter anzeigt), wechselt ihr Status von „ausstehend“ zu „aktiv“.

### Willkommensvorlage (optional)

Listen haben keine Willkommensvorlage. Die einzige E-Mail, die eine Liste von sich aus sendet, ist die Bestätigung des Double Opt-in. Um neue Abonnenten zu begrüßen, bauen Sie eine [Automatisierung](https://www.notifuse.com/de/docs/features/automations.md), die bei `list.subscribed` oder `list.confirmed` für diese Liste auslöst.

### Abmeldevorlage (optional)

Listen haben auch keine Abmeldevorlage. Um Kontakte anzuschreiben, die eine Liste verlassen, verwenden Sie eine Automatisierung, die bei `list.unsubscribed` auslöst.

## Erneute Anmeldung

Versucht ein Kontakt, eine Liste zu abonnieren, auf der er schon einmal stand, richtet sich Notifuse nach seinem aktuellen Status:

| Aktueller Status   | Verhalten                                                                                                                                 |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Aktiv**          | Keine Änderung. Der Kontakt ist bereits angemeldet. Gibt ohne Meldung Erfolg zurück.                                                      |
| **Ausstehend**     | Keine Statusänderung. Die Bestätigungs-E-Mail des Double Opt-in wird erneut gesendet.                                                     |
| **Abgemeldet**     | Erlaubt. Der Status wird auf **„ausstehend“** gesetzt und eine Bestätigungs-E-Mail gesendet, auch wenn die Liste Single Opt-in verwendet. |
| **Zurückgewiesen** | Blockiert. Der Status bleibt unverändert, und es wird keine E-Mail gesendet.                                                              |
| **Beschwerde**     | Blockiert. Der Status bleibt unverändert, und es wird keine E-Mail gesendet.                                                              |

### Warum zurückgewiesene Kontakte und Kontakte mit Beschwerde blockiert werden

Erneute Sendungen an Adressen mit Hard Bounce oder Spam-Beschwerde schaden der Absenderreputation und können Ihre Domain auf eine Blacklist bringen. Diese Kontakte bleiben dauerhaft gesperrt, sowohl in der Anwendung als auch in der Datenbank.

### Verhalten beim Massenimport

Werden Kontakte per CSV oder über die API mit `subscribe_to_lists` importiert, greifen dieselben Schutzmechanismen auf Datenbankebene: Der Listenstatus von Kontakten mit **abgemeldet**, **zurückgewiesen** oder **Beschwerde** wird nicht überschrieben. Ein Massenvorgang kann abgemeldete Kontakte also nicht versehentlich reaktivieren.

### Datenschutz durch Technikgestaltung

Der öffentliche Endpunkt `/subscribe` gibt unabhängig vom Status des Kontakts in der Liste HTTP 200 zurück. Ein Angreifer kann ihn also nicht abfragen, um herauszufinden, ob eine E-Mail-Adresse angemeldet ist. Er gibt 400 bei einer ungültigen Anfrage oder einer nicht öffentlichen Liste zurück, 429 bei zu vielen Versuchen von derselben IP und 500 bei anderen Fehlern.

## Berechtigungen

Listen unterliegen der Berechtigung **Listen**: **Gelesen** zeigt Listen, ihre Einstellungen und ihre Abonnentenzahlen, **Schreiben** legt sie an, bearbeitet und löscht sie und verwaltet Abonnements. Um die Mitgliederadressen einer Liste aufzulisten, braucht es zusätzlich Lesezugriff auf **Kontakte**, und um ein bestehendes Abonnement zu ändern oder zu entfernen, zusätzlich Schreibzugriff auf **Kontakte**.

In der Konsole gelangt ein Mitglied mit Lesezugriff auf Listen, aber ohne Lesezugriff auf Kontakte trotzdem auf die Seite **Kontakte**: Die Leiste zeigt die Listen und ihre Zahlen, aber keine Kontakte.

> [!WARNING]
>
> **Schreibzugriff auf Listen ist implizit Schreibzugriff auf Kontakte.** Eine Anmeldung über
> `/api/lists.subscribe` legt den vollständigen Datensatz des Kontakts an oder überschreibt ihn, mit jedem
> Feld, das die Anfrage enthält, ohne Schreibzugriff auf Kontakte. Ein Mitglied oder API-Schlüssel mit nur
> Schreibzugriff auf Listen kann also trotzdem Ihre Kontaktdaten neu schreiben. Ein authentifizierter Aufruf
> kann außerdem jemanden für eine nicht öffentliche Liste anmelden. Vergeben Sie Schreibzugriff auf Listen
> nur dort, wo Sie auch Schreibzugriff auf Kontakte vergeben würden. Siehe
> [Admins & API-Schlüssel](https://www.notifuse.com/de/docs/features/admins-api-keys.md).

## Bewährte Vorgehensweisen

1. Prüfen Sie regelmäßig den Status Ihrer Kontakte, damit Ihre Listen sauber bleiben.
2. Aktivieren Sie Double Opt-in für die Compliance und damit Sie Abonnenten behalten, die Ihre E-Mails wirklich wollen.
3. Legen Sie für Listen mit Double Opt-in eine Bestätigungsvorlage fest und verwenden Sie Automatisierungen für Willkommens-E-Mails.
4. Verwenden Sie getrennte Listen für unterschiedliche Zielgruppen (z. B. „Newsletter“, „Product Updates“) und kombinieren Sie sie mit Segmentfiltern, um Kampagnen gezielt zu versenden.
