> 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 Zeitfenster-Funktion ermöglicht es, einen oder mehrere Zeiträume zu definieren, in denen der Nutzer **erhält** Benachrichtigungen erhält, und außerhalb derer die Benachrichtigungen stumm sind. Sie befindet sich in den **Einstellungen** des Benachrichtigungszentrums, Abschnitt **Benachrichtigungsplan**.

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

## Konfiguration

### Zeitfenster aktivieren

Den Schalter aktivieren **Benachrichtigungsplan** damit die Zeitfenster-Einschränkungen angewendet werden.

### Zeitfenster festlegen

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

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

Die Zeiten sind auf die **Minute** : `09:00` oder `09:00:00`, nie `09:00:30`. Eine Uhrzeit mit nicht-null Sekunden wird beim Speichern abgelehnt.

**Ein Zeitfenster hinzufügen** ermöglicht es, so viele wie nötig zu definieren, 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 bestehen: Um nichts mehr zu filtern, den Schalter deaktivieren statt die Zeitfenster zu löschen.

### Zeitzone

Die Zeitzone wird automatisch aus dem Browser des Nutzers erkannt (z. B. `Europe/Paris`). Die konfigurierten Zeiten werden für alle Zeitfenster in dieser Zeitzone interpretiert.

## Verhalten

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

## Beispiele

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

* "Benachrichtigungen nur an Werktagen von 9 bis 18 Uhr erhalten" → Plan `active: true`, ein Zeitfenster: startTime `09:00`, endTime `18:00`, daysOfWeek `[1, 2, 3, 4, 5]`
* "Keine Benachrichtigungen während meiner Mittagspause" → zwei Zeitfenster: `09:00–12:00` und `14:00–18:00`, daysOfWeek `[1, 2, 3, 4, 5]` auf jedem
* "Wochentags von 9 bis 18 Uhr und am Samstagvormittag" → zwei Zeitfenster: `09:00–18:00` auf `[1, 2, 3, 4, 5]` und `10:00–12:00` auf `[6]`
* "Benachrichtigungen am Wochenende deaktivieren" → Plan `active: true`, ein Zeitfenster `00:00–23:59` auf daysOfWeek `[1, 2, 3, 4, 5]` : Der Zeitraum wird immer positiv beschrieben, man deckt die Werktage ab, statt das Wochenende zu beschreiben. Die Oberfläche geht nicht unter die Minute, also `23:59` ist das spätestmögliche Ende. Die Endgrenze wird mit der Sekunde `00` dieser Minute verglichen: `23:59:00` ist abgedeckt, aber `23:59:01` um `23:59:59` werden nicht abgedeckt — praktisch ist die letzte Minute des Tages bis auf eine Sekunde stumm.
* Um gar nicht mehr zu filtern, setzt man den Plan auf `active: false` — die Zeitfenster werden nicht gelöscht, es bleibt immer mindestens eines übrig

## Was der Assistent tun kann

Bei aktiviertem Scope **Benachrichtigungen** kann der Assistent:

* Den aktuellen Plan ansehen (Zeitfenster, Zeiten, Tage, Zeitzone, Aktivierung), sofern er aktiviert ist: Sobald der Schalter aus 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 erneut zu aktivieren, fragt der Assistent den vollständigen Plan erneut ab, da er ihn nicht mehr lesen kann