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

# Protokolle

> Protokolle in Echtzeit, um die E-Mail-Zustellung zu überwachen und Probleme mit dem E-Mail-Anbieter zu untersuchen: Nachrichtenereignisse, Webhook-Daten und der Audit-Trail des Arbeitsbereichs, mit Filtern.

## Überblick

Die Protokolle zeigen E-Mail-Aktivität und Webhook-Ereignisse in Echtzeit. So finden Sie Zustellprobleme und verfolgen, wie Ihre Kampagnen abschneiden. Der Bereich enthält außerdem die Zustellungen Ihrer eigenen Webhooks und den **Audit-Trail** des Arbeitsbereichs (wer was von wo aus getan hat), jeweils auf einem eigenen Tab: **Nachrichten**, **Eingehende Webhooks**, **Ausgehende Webhooks** und **Audit-Log**.

## Protokolltypen

### Tab Nachrichten

Hier steht jede E-Mail, die der Arbeitsbereich gesendet hat, die neueste zuerst. Der Standardzeitraum ist **Letzte 24 Stunden**; einen anderen Zeitraum (letzte Stunde, 7 Tage, 30 Tage oder gesamter Zeitraum) wählen Sie im Filter **Zeitraum**.

- **Zahlen nach Status**: Alle, Zugestellt, Geöffnet, Geklickt, Zurückgewiesen, Fehlgeschlagen und Beschwerden. Ein Klick auf einen Status listet nur diese Nachrichten. Die Zahlen erscheinen für Zeiträume bis 7 Tage. Für 30 Tage oder den gesamten Zeitraum fügen Sie einen Filter auf eine E-Mail-Adresse, eine Nachrichten-ID, einen Newsletter, eine Automatisierung, eine Transaktionsbenachrichtigung oder eine Vorlage hinzu. Ein Arbeitsbereich, der nur über SMTP sendet, zeigt keine Zahl für Zugestellt, weil SMTP keine Zustellung meldet.
- **Suchen**: nach E-Mail-Adresse, Nachrichten-ID oder externer ID, mit exakter Übereinstimmung. Sobald Sie ein "@" eingeben, sucht das Feld nach der E-Mail-Adresse, außer Sie haben das Feld selbst gewählt. Eine E-Mail-Adresse wird erst gesucht, wenn sie vollständig ist.
- **Herkunft**: was die Nachricht gesendet hat. Die Prüfungen laufen in dieser Reihenfolge, und die erste, die zutrifft, gilt. Das Dashboard verwendet dieselben Herkünfte.
  - **Newsletter**: Die Nachricht gehört zu einer Kampagne, deren Testsendungen eingeschlossen.
  - **Automatisierungen**: Eine Automatisierung hat sie gesendet. Eine E-Mail einer Automatisierung, die zusätzlich eine Transaktionsbenachrichtigung nennt (das tun einige ältere nach dem Upgrade auf 28.0), zählt zur Automatisierung.
  - **Transaktional**: Eine Transaktionsbenachrichtigung hat sie gesendet.
  - **Andere**: keiner dieser drei Fälle, etwa ein Vorlagentest oder eine Double-Opt-in-Bestätigung.
- **Verlauf**: Jede Zeile zeigt, wie weit die Nachricht gekommen ist: gesendet, zugestellt, geöffnet, geklickt.
- **Fehler**: Wurde ein Versand abgelehnt, steht hier die Antwort des Anbieters selbst, also der SMTP-Code und sein Text, etwa `452: 4.3.1 Daily sending quota exceeded`. Fahren Sie mit der Maus darüber, um sie vollständig zu lesen.
- **Spalten**: In der Spaltenauswahl blenden Sie die Nachrichten-ID, die externe ID, die Metadaten, die Vorlage, die Liste und das Erstellungsdatum ein oder aus.

![Tab Nachrichten der Seite Protokolle](https://www.notifuse.com/docs/assets/screenshots/logs_messages.png)

![Die Zahlen nach Status über den Nachrichten und die Verlaufssymbole jeder Zeile](https://www.notifuse.com/docs/assets/screenshots/logs_status_journey.png)

Ein Klick auf eine Nachricht öffnet sie in einem Seitenbereich. Mit **K** und **J** wechseln Sie zur vorherigen oder nächsten Nachricht.

- **Ereignisse**: wann sie gesendet, zugestellt, geöffnet, geklickt, zurückgewiesen oder als Spam markiert wurde.
- **Nachricht**: ihre IDs, Vorlage und Version, Absender, Betreff, Sprache, Tracking, Liste und Anhänge sowie der Newsletter, die Automatisierung oder die Transaktionsbenachrichtigung, die sie gesendet hat.
- **Gesendeter Inhalt**: die E-Mail, neu gerendert aus ihrer Vorlage und den Daten der Nachricht, in der Sprache des Kontakts, als HTML, Text oder MJML. Notifuse speichert das gesendete HTML nicht. Es rendert die Vorlage in der Version, die die Nachricht verwendet hat, deshalb erscheinen spätere Änderungen an der Vorlage hier nicht.
- **Daten**: die Vorlagendaten und die Metadaten, mit denen die Nachricht gesendet wurde.
- **Kontakt öffnen** öffnet das Profil des Kontakts.

Wird ein Kontakt gelöscht, bleiben seine Nachrichten als **Kontakt gelöscht** im Protokoll, ohne seine Daten.

![Eine Nachricht im Seitenbereich der Seite Protokolle, mit ihren Ereignissen und Details](https://www.notifuse.com/docs/assets/screenshots/logs_message_detail.png)

### Tab Eingehende Webhooks

Hier stehen die Ereignisse, die Notifuse von Ihren E-Mail-Anbietern und von Supabase aufbewahrt hat, die neuesten zuerst, standardmäßig aus den letzten 24 Stunden.

- **Filter**: Suche nach Empfänger-E-Mail oder Nachrichten-ID; Filter nach Zeitraum, nach **Quelle** (Amazon SES, Postmark, Mailgun, SparkPost, Mailjet, SendGrid, SMTP, Supabase) und nach **Typ** (zugestellt, Bounce, Beschwerde, Abmeldung, Antwort, automatische Antwort, Authentifizierungs-E-Mail, Benutzer erstellt). Die Filter bleiben im Link der Seite erhalten.
- **Verknüpfte Nachricht**: Ein Zustell-, Bounce-, Beschwerde- oder Abmeldeereignis verweist auf die Nachricht, um die es geht. Eine Antwort trägt ihre eigene Nachrichten-ID und verweist deshalb nirgendwohin.
- **Rohdaten**: Klicken Sie auf ein Ereignis, um seine Bounce- oder Beschwerdedetails und seine Daten genau so zu sehen, wie der Anbieter sie gesendet hat. Bündelt ein Anbieter seine Ereignisse (SendGrid, SparkPost, Mailjet), erhält jedes Ereignis des Bündels einen eigenen Eintrag.
- **Von Notifuse gesendete E-Mails**: Ein Zustell-, Bounce-, Beschwerde- oder Abmeldeereignis wird nur aufgeführt und verarbeitet, wenn es eine von Notifuse gesendete E-Mail betrifft, und zwar für die Adresse, an die sie ging. Eine Antwort zählt nur, wenn sie auf eine von Notifuse gesendete E-Mail antwortet. Ereignisse zu anderen E-Mails, etwa denen einer anderen Anwendung auf demselben Anbieterkonto oder der Test-E-Mail einer Integration, werden ignoriert.

![Tab Eingehende Webhooks der Seite Protokolle, mit Zustellereignissen von Amazon SES](https://www.notifuse.com/docs/assets/screenshots/logs_webhooks.png)

### Tab Ausgehende Webhooks

Jede Zustellung Ihrer [Webhook-Abonnements](https://www.notifuse.com/de/docs/features/webhooks.md), die neueste zuerst:

- **Filter**: nach Abonnement und nach Status (Ausstehend, Wird zugestellt, Zugestellt, Fehlgeschlagen), im Link der Seite gespeichert
- **Erneuter Versuch**: Eine fehlgeschlagene Zustellung, die noch Versuche übrig hat, zeigt **Erneuter Versuch**, und ihr Seitenbereich nennt die Zeit des nächsten Versuchs. Der Filter **Fehlgeschlagen** listet diese Zustellungen ebenfalls
- **Zustelldetails**: Ein Klick auf eine Zustellung zeigt den Antwortcode und den Body, mit denen Ihr Endpunkt geantwortet hat, sowie die Payload, die Notifuse gesendet hat. **Abonnement öffnen** führt zu diesem Abonnement unter Einstellungen → Webhooks

### Tab Audit-Log

Jeder Eintrag liest sich wie ein Satz, etwa "Hat **[ann@example.com](mailto:ann@example.com)** eingeladen". Sie filtern nach Zeitraum, Akteur, Ressource, Aktion oder Ergebnis, und die Filter bleiben im Link der Seite erhalten.

- **Wer was getan hat**: jede Aktion auf der Steuerungsebene (ein Mitglied eingeladen, eine Berechtigung geändert, ein API-Schlüssel erstellt, eine Integration bearbeitet, eine Vorlage gespeichert, eine Kampagne geplant), mit dem Akteur, der IP-Adresse, dem Ergebnis und einem Vorher/Nachher der Änderung
- **Nur anfügbar**: Ein Datenbank-Trigger lehnt jedes Überschreiben ab; die Bereinigung nach Ablauf der Aufbewahrungsfrist ist die einzige Löschung
- **Exportierbar**: Laden Sie den aktuellen Filter als CSV oder NDJSON herunter, oder holen Sie ihn über die API in ein SIEM

Die Aufzeichnung ist eine Funktion des Enterprise-[Lizenzschlüssels](https://www.notifuse.com/de/docs/self-hosting/licence.md). Der Tab, sein Export und seine Aufbewahrungseinstellung funktionieren in jedem Lizenzzustand. Die vollständige Referenz finden Sie unter [Audit-Logs](https://www.notifuse.com/de/docs/features/audit-logs.md).

## Aktualisierung der Ereignisse

E-Mail-Ereignisse werden in Echtzeit aktualisiert, sobald die Webhooks der Anbieter eintreffen:

- **Zugestellt**: Die E-Mail wurde dem Empfänger zugestellt
- **Geöffnet**: Der Empfänger hat die E-Mail geöffnet
- **Geklickt**: Der Empfänger hat auf einen Link in der E-Mail geklickt
- **Zurückgewiesen**: Die Zustellung der E-Mail ist fehlgeschlagen
- **Beschwerde**: Der Empfänger hat die E-Mail als Spam markiert

## Filteroptionen

Neben der Suche, dem Zeitraum, der Herkunft und den Zahlen nach Status bietet **+ Filter** im Tab Nachrichten:

- **Status**: zugestellt, geöffnet, geklickt, zurückgewiesen, fehlgeschlagen, Beschwerde oder abgemeldet, oder das jeweilige Gegenteil (nicht zugestellt, nicht geöffnet …)
- **Kanal**: der Kanal, über den die Nachricht ging
- **Liste**, **Newsletter** und **Automatisierung**: nach Name ausgewählt
- **Vorlage** und **Transaktionsbenachrichtigung**: nach ID. Die Detailansicht einer Benachrichtigung öffnet das Protokoll mit diesem Filter (`transactional_notification_id` in `messages.list`)
- **Geklickter Link**: innerhalb eines Newsletters nur die Nachrichten, in denen genau dieser Link geklickt wurde. Die Statistiken pro Link einer Kampagne öffnen das Protokoll mit diesem Filter (**Anzeigen, wer geklickt hat**). Über die API übergeben Sie `clicked_url` zusammen mit `broadcast_id` an `messages.list`

Jeder Filter bleibt im Link der Seite erhalten, Sie können eine gefilterte Ansicht also teilen oder als Lesezeichen speichern. Über die API filtert `messages.list` mit `origin` nach Herkunft (`broadcast`, `automation`, `transactional` oder `other`), und `messages.count` liefert dieselben Zahlen für die Filter von `messages.list`. Dafür braucht es `created_after` oder einen Filter auf eine Nachrichten-ID, eine E-Mail-Adresse, einen Newsletter, eine Automatisierung, eine Transaktionsbenachrichtigung oder eine Vorlage. Die Dimension `origin` des Analytics-Schemas `message_history` liefert dieselben vier Werte.

## Berechtigungen

Die Seite zeigt nur die Tabs, die Sie lesen dürfen, und der Menüeintrag Protokolle erscheint, sobald Sie mindestens einen davon lesen dürfen. Jeder Tab braucht sein eigenes Leserecht:

- **Nachrichten** braucht das Leserecht für **Nachrichtenverlauf**. Auch die Zustellstatistiken der Kampagnen (Zahlen zu Zustellungen, Öffnungen, Klicks, Bounces und pro Link) liegen hier. Ein Mitglied, das eine Kampagne erstellen und senden darf, sieht ohne diese Berechtigung also nicht, wie sie abgeschnitten hat. Das Protokoll enthält Empfängeradressen und die Daten, mit denen jede Nachricht gerendert wurde; behandeln Sie es deshalb wie Kontaktdaten.
- **Eingehende Webhooks** braucht das Leserecht für **Webhook-Ereignisse**. Das sind die Payloads der Anbieter selbst, mit Empfängeradressen und Diagnosedaten der Anbieter.
- **Ausgehende Webhooks** braucht das Leserecht für **Webhook-Abonnements**.
- **Audit-Log** braucht das Leserecht für **Audit-Logs**, das ein Inhaber bewusst vergibt. Es gehört nie zum Vollzugriff, denn Vollzugriff soll nicht heißen, dass jemand die E-Mail-Adresse, die IP-Adresse und die abgelehnten Aktionen aller Kollegen lesen kann. Inhaber sehen den Tab immer, und ein Root-Benutzer kann ihn auf das gesamte Deployment umschalten.

Das Schreibrecht für Nachrichtenverlauf, Webhook-Ereignisse und Audit-Logs steuert derzeit nichts. Diese Zeilen schreiben die Versand-Pipeline, die Callback-Routen der Anbieter und der Audit-Rekorder der Plattform, und keiner Ihrer Aufrufe kann es. Das Schreibrecht für Webhook-Abonnements steuert dagegen etwas: Damit kann ein Mitglied oder ein API-Schlüssel die Abonnements erstellen, bearbeiten, ein- und ausschalten, löschen und testen (in der Konsole unter Einstellungen → Webhooks). Siehe [Admins & API-Schlüssel](https://www.notifuse.com/de/docs/features/admins-api-keys.md).

## E-Mail-Probleme untersuchen

Mit den Protokollen beheben Sie Probleme mit dem E-Mail-Anbieter:

- **Zustellfehler**: zurückgewiesene E-Mails und ihre Gründe finden und in der Spalte Fehler lesen, warum ein Versand abgelehnt wurde
- **Anbieterprobleme**: Muster bei Webhook-Fehlern erkennen
- **Leistungsüberwachung**: Öffnungs- und Klickraten verfolgen
- **Debugging in Echtzeit**: Versandprobleme sehen, während sie auftreten
