Zum Inhalt springen

Prioritätsstufen & kritische Alarme ​

Jede Pocket-Alert-Nachricht hat eine Prioritätsstufe, die bestimmt, wie laut sie ankommt: lautlos im Benachrichtigungsbereich, als normaler Banner oder als kritischer Alarm, der das Gerät über den Stummschalter und den Modus „Nicht stören“ weckt.

Die fünf Stufen ​

StufeAliaseVerhalten
silentmin, -2Nur im Benachrichtigungsbereich zugestellt — kein Ton, keine Vibration
low-1Leise, keine Unterbrechung
defaultnormal, 0 (oder weggelassen)Standard-Banner + Ton
high1Zeitkritisch — durchbricht Fokus und geplante Zusammenfassung
criticalmax, urgent, 2Weckt das Gerät über den Stummschalter und den Modus „Nicht stören“

Beide Schreibweisen funktionieren überall: Sende "level": "critical" oder "level": 2. Bei der Nachricht erstellen-API wird das Feld auch als priority akzeptiert; Webhooks lesen nur level.

Was jede Stufe auf dem Gerät bewirkt ​

iOS ordnet die Stufen den APNs-Unterbrechungsstufen zu — passive, active, time-sensitive und critical. Ein critical-Alarm nutzt Apples Berechtigung für kritische Alarme, die den Ton mit eigener Lautstärke abspielt, selbst wenn der Klingelton aus ist und „Nicht stören“ aktiv ist. iOS fragt separat nach der Berechtigung Kritische Alarme; ist sie unter Einstellungen → Mitteilungen → Pocket Alert deaktiviert, kommen critical-Nachrichten stattdessen als time-sensitive an.

Android ordnet die Stufen eigenen Benachrichtigungskanälen zu. critical verwendet einen Kanal mit hoher Wichtigkeit, der „Nicht stören“ umgeht, sowie einen Vollbild-Intent, sodass der Alarm den Bildschirm übernimmt, statt im Benachrichtigungsbereich zu warten.

Da jede Stufe ein eigener Android-Kanal ist, können Nutzer deine Routine-Benachrichtigungen in den Systemeinstellungen stummschalten und die kritischen trotzdem aktiv lassen.

Wo du sie festlegst ​

Die Priorität wird in dieser Reihenfolge aufgelöst, der erste Treffer gewinnt:

  1. Pro Nachricht — das Feld level bei Nachricht erstellen, der Prioritätsauswahl im Dashboard oder ein oberstes Feld level in einer an einen Webhook gesendeten Payload.
  2. Pro Webhook — eine Standardstufe am Webhook für Nachrichten, die über ihn eingehen, sodass eine eingehende Payload direkt auf einen Schweregrad abgebildet wird.
  3. Pro Anwendung — eine Standardstufe an der Anwendung, gilt für jede Nachricht, die keine eigene setzt.
  4. Fallback — default.

Genau diese Reihenfolge macht einen einzelnen Webhook sowohl für Routine- als auch für dringende Ereignisse nützlich: Setze den Webhook auf high und lass einzelne Aufrufe nach oben überschreiben, wenn wirklich etwas kaputtgeht.

Tarifgrenzen ​

Kritisch ist eine kostenpflichtige Funktion

Im kostenlosen Tarif wird critical automatisch auf high herabgestuft, statt abgelehnt zu werden — der Alarm kommt trotzdem an, überschreibt aber nicht den Modus „Nicht stören“. Alle anderen Stufen funktionieren in jedem Tarif.

Ein unbekannter Stufenname oder eine Ganzzahl außerhalb von -2..2 liefert 400 zurück.

In der App nach Priorität filtern ​

Der mobile Feed nutzt dieselben Stufen. Tippe auf das Filtersymbol, um eine oder mehrere Stufen auszuwählen, auf einen Datumsbereich einzugrenzen oder den gesamten Feed nach Schweregrad statt nach Zeit zu sortieren — praktisch, wenn du mit vierzig Benachrichtigungen zu deinem Handy zurückkommst und nur die zwei brauchst, die wirklich wichtig waren.

Die richtige Stufe wählen ​

Eine Faustregel, die deine Benachrichtigungen vertrauenswürdig hält:

  • critical — jemand muss jetzt handeln, zu jeder Uhrzeit. Produktion ausgefallen, Sicherheitsvorfall, Kühlschrank über der Temperaturgrenze.
  • high — braucht Aufmerksamkeit innerhalb der nächsten Stunde. Fehlgeschlagenes Deployment, Zahlung abgelehnt, Warteschlange läuft voll.
  • default — heute wissenswert. Build abgeschlossen, neue Registrierung, Formular abgeschickt.
  • low / silent — Protokoll auf deinem Handy. Cronjob planmäßig beendet, nächtliches Backup abgeschlossen.

Der Sinn von Stufen ist nicht, jeden Alarm lauter zu machen. Sie sollen dafür sorgen, dass die lauten auch etwas bedeuten.

Siehe auch ​

Pocket Alert Dokumentation