# Die erste Benachrichtigung

Beginnen Sie mit geöffneter Außenposten-Konsole. Dieses Tutorial überwacht den Kundenordner eines Arbeitspostfachs und sendet Benachrichtigungen über Bark. Sie werden den vollständigen Ablauf mit einer neuen E-Mail überprüfen.

## 1. Erstellen Sie einen Administrator

Suchen Sie beim ersten Start den Setup-Code in `docker compose logs --tail=50 core`, geben Sie ihn in die Konsole ein und erstellen Sie ein Passwort mit mindestens 12 Zeichen. Wenn die Einrichtung abgeschlossen ist, melden Sie sich mit Ihrem vorhandenen Administratorkennwort an.

**Überprüfen Sie das Ergebnis**: Der Einrichtungsassistent oder die Übersicht wird geöffnet. Sie können Postfächer und Benachrichtigungen separat konfigurieren.

## 2. Fügen Sie ein Postfach hinzu

Öffnen Sie **Postfächer → Postfach hinzufügen** und geben Sie die Verbindungseinstellungen ein:

- **Beschriftung**: zum Beispiel „Arbeitspostfach“. Es erscheint in den Konsolen- und Benachrichtigungstiteln.
- **IMAP-Host**: Verwenden Sie die Adresse aus den IMAP-Einstellungen Ihres E-Mail-Anbieters.
- **Port**: normalerweise `993` , mit TLS.
- **Benutzername**: in der Regel Ihre vollständige E-Mail-Adresse.
- **Passwort**: Verwenden Sie bei Bedarf ein vom Anbieter ausgegebenes App-Passwort oder einen Autorisierungscode.

Testen Sie die Verbindung und speichern Sie. Gmail verwendet `imap.gmail.com` auf `993`; Die Verfügbarkeit von App-Passwörtern hängt von den Konto- und Organisationsrichtlinien ab. Siehe [Googles Anleitung](https://support.google.com/accounts/answer/185833?hl=en). Bei anderen Anbietern verwenden Sie deren veröffentlichte IMAP-Einstellungen.

**Überprüfen Sie das Ergebnis**: Das Postfach erscheint in der Seitenleiste und Sie können es öffnen und Ordner scannen. Überprüfen Sie bei Authentifizierungsfehlern, ob IMAP aktiviert ist, der Benutzername vollständig ist und das App-Passwort gültig ist.

## 3. Wählen Sie die Ordner aus, die Sie ansehen möchten

Öffnen Sie das Postfach, wählen Sie **Ordner scannen → Scan starten** und wählen Sie die Ordner aus, die Benachrichtigungen benötigen. Wenn eine serverseitige Regel Kundennachrichten an Clients verschiebt, wählen Sie Clients aus.

- **Echtzeit**: für Ordner, die sofortige Benachrichtigungen benötigen.
- **Alle 5 Minuten / Alle 15 Minuten**: Sie können Quittungen oder Newsletter später überprüfen.

Wählen Sie **Weiter**, überprüfen Sie die Auswahl und speichern Sie. Das Verbindungsbudget zeigt die Nutzung an; Schalten Sie einige Ordner auf geplante Prüfungen um, wenn Sie das Limit erreichen.

**Überprüfen Sie das Ergebnis**: Der Überwachungsstatus listet Ihre ausgewählten Ordner als Überwachung auf, mit einem Zeitpunkt der letzten Überprüfung. Neue Abonnements legen einen Ausgangspunkt an der aktuellen Postfachposition fest, sodass vorhandene Nachrichten übersprungen werden.

## 4. Richten Sie Bark-Benachrichtigungen ein

Aktivieren Sie Systembenachrichtigungen für Bark auf Ihrem Telefon und suchen Sie nach der Push-URL. Wählen Sie für eine URL wie `https://api.day.app/your-device-key` unter **Benachrichtigungen** im Außenposten die Option „Bark“ aus:

- Setzen Sie **Endpoint** auf `https://api.day.app` oder Ihre eigene HTTPS-Bark-Serveradresse.
- Geben Sie nur den Geräteschlüsselteil in **Bark-Geräteschlüssel** ein.
- Wählen Sie aus, ob E-Mail-Betreffs angezeigt werden sollen. Wenn die Vorschau deaktiviert ist, verwenden Benachrichtigungen eine generische neue E-Mail-Nachricht.

Speichern Sie, wählen Sie **Testbenachrichtigung senden** und überprüfen Sie Ihr Telefon.

**Überprüfen Sie das Ergebnis**: Der Außenposten meldet, dass der Benachrichtigungsdienst die Anfrage angenommen hat, und das Telefon zeigt eine Testbenachrichtigung an. Die Annahme erfasst die Serviceantwort; Die Geräteanzeige hängt auch von Benachrichtigungsberechtigungen, Fokusmodi und Kanalstatus ab.

Geben Sie für Pushover ein Anwendungs-Token und einen Benutzerschlüssel ein. Geben Sie für Webhook eine HTTPS-Empfänger-URL und ein Signaturgeheimnis ein. Informationen zu Feldern und Signaturen finden Sie im [Benachrichtigungsreferenz](notifications.md).

## 5. Bestätigen Sie mit einer neuen E-Mail

1. Halten Sie den Außenposten am Laufen und bestätigen Sie, dass die Clients die Überwachung durchführen.
2. Senden Sie eine neue E-Mail aus einem anderen Postfach, damit Ihre serverseitige Regel sie in Clients verschieben kann.
3. Bestätigen Sie, dass sich die Nachricht in Clients befindet, indem Sie Webmail oder Ihren üblichen E-Mail-Client verwenden.
4. Suchen Sie den Eintrag unter **Lieferungen** im Außenposten und überprüfen Sie dann die telefonische Benachrichtigung.

**Überprüfen Sie das Ergebnis**: Die Benachrichtigung identifiziert das Postfach und den Ordner. Wenn die Probandenvorschau aktiviert ist, wird auch das Testsubjekt angezeigt. Lesen und antworten Sie weiter in Ihrem vorhandenen E-Mail-Client.

Verwenden Sie für den Test eine neue E-Mail. Durch das Verschieben von E-Mails, die vor mehr als 24 Stunden eingegangen sind, wird der Überwachungsfortschritt vorangetrieben, ohne dass eine Benachrichtigung generiert wird. Eine Nachricht, die in zwei abonnierten Ordnern erscheint, kann zwei Ordnerbenachrichtigungen generieren.

## 6. Finden Sie heraus, wo die Lieferung endet

- **Die Testbenachrichtigung schlägt ebenfalls fehl**: Überprüfen Sie die Kanalanmeldeinformationen, die Konnektivität vom Außenposten zum Dienst und die Berechtigungen für die Telefonbenachrichtigung.
- **Der Test ist erfolgreich, aber es liegen keine neuen E-Mails vor**: Bestätigen Sie, dass der Zielordner der Regel abonniert ist, und überprüfen Sie dessen Status und die Zeit der letzten Überprüfung. Erlauben Sie das ausgewählte Intervall für geplante Ordner.
- **Zustellung ist als fehlgeschlagen markiert**: Lesen Sie den Grund, korrigieren Sie die Kanaleinstellungen und versuchen Sie es manuell erneut. Automatische Wiederholungen sind standardmäßig auf 0 eingestellt und können in Benachrichtigungen konfiguriert werden.
- **Das Postfach benötigt eine Authentifizierung**: Aktualisieren Sie das App-Passwort in den Postfacheinstellungen.

Zum Abschluss erstellen Sie Ihr erstes [Sicherung](backup.md). Der Konsolenverlauf zeichnet Benachrichtigungen auf. Originalnachrichten verbleiben in Ihrem Postfach.
