Wie richte ich Benachrichtigungen und Empfängergruppen ein?

Ab Tarif Pro

Kurzantwort

Im Bereich Betrieb legst du auf dem Reiter Benachrichtigungen eine Meldung an (Titel, Nachricht, Stufe) und ordnest sie optional einer Gruppe zu. Empfängergruppen pflegst du auf dem Reiter Gruppen (Name + kommagetrennte E-Mail-Adressen). Ungelesene Benachrichtigungen zählt das Glocken-Symbol oben in der Kopfzeile.

Voraussetzungen

Der Betrieb ist Teil des Moduls Operations und ab Tarif Pro verfügbar.

Empfängergruppe anlegen (optional). Öffne Betrieb → Gruppen und klicke auf „Gruppe hinzufügen”. Vergib einen Namen, trage unter Empfänger (E-Mails, Komma) die Adressen ein (z. B. it@example.com, ops@example.com) und speichere.

Screenshot ausstehend betrieb-benachrichtigungen-01 Reiter Gruppen im Bereich Betrieb mit dem Dialog zum Anlegen einer Empfängergruppe

Eine Empfängergruppe mit kommagetrennten E-Mail-Adressen.
Benachrichtigung anlegen. Wechsle auf den Reiter Benachrichtigungen und klicke „Benachrichtigung hinzufügen”. Fülle den Dialog:
- Titel (Pflicht).
- Nachricht (optional): Freitext.
- Stufe (Pflicht): Information, Warnung, Fehler oder Erfolg.
- Gruppe (optional): die zuvor angelegte Empfängergruppe.
Screenshot ausstehend betrieb-benachrichtigungen-02 Dialog 'Benachrichtigung hinzufügen' mit Titel, Nachricht, Stufe und Gruppenauswahl

Eine Benachrichtigung mit Stufe und optionaler Empfängergruppe.
Lesen und quittieren. Neue, ungelesene Benachrichtigungen erhöhen den Zähler am Glocken-Symbol in der Kopfzeile. Öffnest du eine Benachrichtigung, gilt sie als gelesen und der Zähler sinkt.

Gruppe anlegen ist ein POST auf /api/v1/notification-groups:

curl -X POST https://demo.notory.io/api/v1/notification-groups \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{ "name": "IT-Betrieb", "recipients": "it@example.com, ops@example.com" }'

Benachrichtigung anlegen ist ein POST auf /api/v1/notifications (group_id optional):

curl -X POST https://demo.notory.io/api/v1/notifications \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Zertifikat läuft in 14 Tagen ab",
    "message": "www.example.com — bitte erneuern",
    "level": "warning",
    "group_id": "8b1c…"
  }'

Ungelesen-Zähler und als gelesen markieren:

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/notifications-unread-count
# → { "unread": 3 }

curl -X POST https://demo.notory.io/api/v1/notifications/7f3a.../read \
  -H "Authorization: Bearer inv_dein_token"

Mögliche Fehler: 401 (Token fehlt/ungültig), 403 (Modul Operations nicht im Tarif oder kein Schreibrecht), 404 (Benachrichtigung nicht gefunden), 422 (Validierung).

Was passiert dabei?

is_read-Status: Jede Benachrichtigung startet als ungelesen. Das Öffnen (bzw. der .../read-Aufruf) setzt is_read = true; der Ungelesen-Zähler zählt nur ungelesene Einträge des Mandanten.
Gruppen sind Empfängerlisten: Eine Gruppe bündelt kommagetrennte E-Mail-Adressen. Wird eine Gruppe gelöscht, bleiben zugeordnete Benachrichtigungen erhalten; ihr group_id wird auf null gesetzt.
Mandanten-Isolation & Audit: Benachrichtigungen und Gruppen gehören deinem Mandanten; Anlegen/Ändern/Löschen wird protokolliert.
Verknüpfung mit Monitoring: Verletzt eine Alarmregel ihren Schwellenwert, erzeugt Notory automatisch eine Benachrichtigung. So laufen technische Alarme hier zusammen.