> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/de/notifications/notifications-plage-horaire.md).

# Zeitfenster — Recht auf Abschalten

Die Funktion für Zeitfenster ermöglicht es, ein oder mehrere Zeitfenster festzulegen, in denen der Benutzer **erhält** Benachrichtigungen, und außerhalb derer die Benachrichtigungen stumm sind. Sie befindet sich in den **Einstellungen** des Benachrichtigungszentrums, Abschnitt **Benachrichtigungsplanung**.

Nur die Kanäle **Push und E-Mail** betroffen sind: Die Benachrichtigungen kommen weiterhin im Benachrichtigungszentrum an, das als Archiv dient.

## Konfiguration

### Zeitfenster aktivieren

den Toggle aktivieren **Benachrichtigungsplanung** damit die Zeitfenster-Beschränkungen greifen.

### Zeitfenster festlegen

Jedes Zeitfenster hat eigene Tage und eigene Uhrzeiten, die in dieser Reihenfolge eingegeben werden:

* **Tage** : Montag (1), Dienstag (2), Mittwoch (3), Donnerstag (4), Freitag (5), Samstag (6), Sonntag (7)
* **Ab** : Uhrzeit, ab der Benachrichtigungen gesendet werden beginnen (z. B. `09:00`)
* **Bis** : Uhrzeit, zu der die Benachrichtigungen aufhören (z. B. `18:00`)

Die Uhrzeiten sind auf die **Minute** : `09:00` oder `09:00:00`, niemals `09:00:30`. Eine Uhrzeit mit von null verschiedenen Sekunden wird beim Speichern abgelehnt.

**Zeitfenster hinzufügen** ermöglicht, so viele festzulegen, wie nötig sind, ohne Begrenzung der Anzahl. Ein Zeitfenster muss nach seinem Beginn enden: Eine Pause in der Mitte des Tages wird also durch zwei Zeitfenster dargestellt (zum Beispiel `09:00–12:00` und `14:00–18:00`), nicht durch ein umgekehrtes Zeitfenster.

Es bleibt immer mindestens ein Zeitfenster: Um gar nichts mehr zu filtern, den Toggle deaktivieren statt die Zeitfenster zu löschen.

### Zeitzone

Die Zeitzone wird automatisch über den Browser des Benutzers erkannt (z. B. `Europe/Paris`). Die konfigurierten Uhrzeiten werden in dieser Zeitzone für alle Zeitfenster interpretiert.

## Verhalten

* Wenn das Zeitfenster **active**aktiv ist,**mindestens ein** Zeitfenster den aktuellen Tag und die aktuelle Uhrzeit abdeckt
* Wenn das Zeitfenster **active** und kein Zeitfenster den aktuellen Moment abdeckt → die Benachrichtigungen werden nicht über die Kanäle Push und E-Mail gesendet
* Wenn das Zeitfenster **deaktiviert** → die Benachrichtigungen werden jederzeit gesendet
* Überlappende Zeitfenster werden akzeptiert und verursachen keine Dubletten

## Beispiele

`active` und `Zeitzone` beschreiben den gesamten Plan; jedes Zeitfenster enthält nur `startTime`, `endTime` und `daysOfWeek`.

* "Benachrichtigungen nur unter der Woche von 9 bis 18 Uhr empfangen" → Plan `active: true`, ein Zeitfenster: startTime `09:00`, endTime `18:00`, daysOfWeek `[1, 2, 3, 4, 5]`
* "Während meiner Mittagspause keine Benachrichtigungen" → zwei Zeitfenster: `09:00–12:00` und `14:00–18:00`, daysOfWeek `[1, 2, 3, 4, 5]` jeweils
* "Unter der Woche von 9 bis 18 Uhr und am Samstagvormittag" → zwei Zeitfenster: `09:00–18:00` nach `[1, 2, 3, 4, 5]` und `10:00–12:00` nach `[6]`
* "Benachrichtigungen am Wochenende deaktivieren" → Plan `active: true`, ein Zeitfenster `00:00–23:59` bei daysOfWeek `[1, 2, 3, 4, 5]` : Das Zeitfenster wird immer positiv beschrieben; man deckt die Werktage ab, statt das Wochenende zu beschreiben. Die Oberfläche geht nicht unter die Minute, daher `23:59` ist das späteste mögliche Ende. Die Endgrenze wird mit der Sekunde `00` dieser Minute verglichen: `23:59:00` ist abgedeckt, aber `23:59:01` bis `23:59:59` nicht — in der Praxis ist die letzte Minute des Tages bis auf eine Sekunde still.
* Um gar nicht mehr zu filtern, wird der Plan auf `active: false` — man löscht die Zeitfenster nicht, es bleibt immer mindestens eines

## Was der Assistent tun kann

Mit dem Scope **Benachrichtigungen** kann der Assistent:

* Den aktuellen Plan einsehen (Zeitfenster, Uhrzeiten, Tage, Zeitzone, Aktivierung), sofern er aktiviert ist: Sobald der Toggle ausgeschaltet ist, sieht der Assistent die gespeicherten Zeitfenster nicht mehr
* Zeitfenster konfigurieren oder ändern (der Aufruf ersetzt den gesamten Plan)
* Das Zeitfenster aktivieren oder deaktivieren — um es wieder zu aktivieren, fragt der Assistent den vollständigen Plan erneut ab, da er ihn nicht mehr lesen kann
