Dokumentation

Benachrichtigungen

Meldungen der Organisation, Ungelesen-Zähler und Webhooks.

Benachrichtigungen gehören der Organisation, nicht einem einzelnen Mitglied. Alle Mitglieder sehen dieselben Meldungen. Die Glocke im Dashboard zeigt die Zahl der ungelesenen Einträge.

Arten

Art	Auslöser
registration_created	Eine neue öffentliche Anmeldung.
registration_cancelled	Eine Anmeldung wurde storniert.
registration_promoted	Eine Anmeldung ist von der Warteliste nachgerückt.
registration_checked_in	Eine Anmeldung wurde eingecheckt.
survey_response	Eine neue Antwort auf eine Umfrage.
message_sent	Eine Nachricht wurde versandt.

Lesen und als gelesen markieren

Die Benachrichtigungsseite lädt die neuesten Meldungen. Standard sind 20 Einträge, höchstens 100. Ein Filter unread_only zeigt nur ungelesene Meldungen.

GET /api/notifications?limit=20&unread_only=false liefert Meldungen und die Zahl der ungelesenen Einträge.
POST /api/notifications/read mit einer Liste von IDs markiert genau diese Meldungen.
Ohne IDs markiert derselbe Aufruf alle ungelesenen Meldungen der Organisation.
Die Antwort enthält die verbleibende Zahl der ungelesenen Meldungen.

Diese Endpunkte brauchen ein Sitzungs-Token, keinen API-Schlüssel. Sie stehen nicht unter /api/v1.

Webhooks

Jede neue Benachrichtigung kann zusätzlich an aktive Webhooks der Organisation gesendet werden. Webhooks gehören zu Eventwerk Plus. Die Zustellung läuft im Hintergrund und hat keine dauerhafte Warteschlange.

SMS, Push und WhatsApp sind als Benachrichtigungskanäle geplant, aber noch nicht gebaut. Die Benachrichtigungen sind derzeit nur in der Oberfläche und über die API abrufbar.