| `message` | String | Die Hauptnachricht der Benachrichtigung, die dem Benutzer angezeigt wird. | `"Rauchmelder-Alarm! Bitte überprüfen!"` |
| `data` | Objekt | Enthält zusätzliche Informationen und Konfigurationen für die Benachrichtigung. | Siehe unten. |
| `channel` | String | Der Benachrichtigungskanal, der für Android verwendet wird. Kanäle steuern Benachrichtigungseigenschaften wie Ton oder Priorität. | `"Alarm"` |
| `priority` | String | **`priority`** ist ein älteres, legacy‑Feld, das vor allem auf Android < 8.0 (NotificationCompat) greift.
Auf neueren Geräten (ab Android 8.0) wird `priority` zwar noch akzeptiert, **empfohlen** wird aber, den Kanal per `importance` korrekt zu konfigurieren und `priority` nur als Fallback zu verwenden.
Die Property **`priority`** legt fest, wie wichtig die Notification vom Betriebssystem eingestuft wird und beeinflusst vor allem auf **Android**, ob sie als **Heads‑Up**‑Popup aufplatzt oder eher still im Hintergrund landet.
- **`priority: "high"`** ⇒ kurze Heads‑Up‑Notification oben am Bildschirm, mit Ton (vorausgesetzt der Kanal/Stream ist entsprechend konfiguriert)
- **`priority: "default"`** ⇒ normale Mitteilung ohne Popup
- **`priority: "low"`** oder **`"min"`** ⇒ möglichst unaufdringlich (kein Ton, kein Banner)
**Tipp:** Für Alarm‑ oder TTS‑Nachrichten immer **`"high"`** verwenden, damit die Nachricht wirklich direkt auffällt.
| `"high"` |
| importance | String
| Auf Android‑Geräten (ab Version 8.0+) wird die Wichtigkeit eines Notification‑**Kanals** über das `importance`‑Feld gesteuert. Die möglichen Werte sind:
- `min`
- `low`
- `default`
- `high`
- `max`
Die Beschreibung der Werte Siehe Tabelle importance
|
|
| `ttl` | Integer | **`ttl`** steht für **Time To Live** und bestimmt, wie lange eine Notification auf dem Server zwischengespeichert und immer wieder zugestellt wird, falls das Gerät gerade offline ist.
- **`ttl: 0`** → Nachricht wird sofort zugestellt und **nicht** zwischengespeichert.
- **`ttl: 3600`** → Nachricht bleibt bis zu 1 Stunde aktiv und wird wiederholt, bis sie zugestellt oder die Stunde abgelaufen ist.
**Merke:** Ein hoher `ttl`‑Wert sorgt dafür, dass du auch dann noch benachrichtigt wirst, wenn dein Handy gerade keine Verbindung hatte.
| `0` |
| `push` | Array
| Push ist ein Array für iOS, zum Verständnis sind bei den nächsten beiden Parametern das Wort push davor, damit man man weis wo zu es gehört. Der Typ String bezieht sich auf das Element in push
|
|
| `push.category` | String
| Auf iOS gibt es kein Äquivalent zu den Android‑Feldern `priority` oder `importance` – die werden von der Companion App schlicht ignoriert. Stattdessen steuerst du das Verhalten über zwei iOS‑spezifische Felder in deinem Payload:
**`push.category`**
- Legt fest, in welche Kategorie (notification, alarm, silent) die Notification fällt.
`alarm` spielt deinen definierten Ton auch im „Nicht stören“ ab.
Es werden folgende Werte unterstützt:
- **`notification`** (Standard)
- Anzeige: Banner in der Mitteilungszentrale und auf dem Sperrbildschirm
- Ton: Spielt einen Ton ab, sofern das Gerät nicht stumm geschaltet ist und der User es erlaubt
- Einsatz: Allgemeine Hinweise, Status‑Updates, alles, was keine besondere Dringlichkeit hat
- **`alarm`**
- Anzeige: Banner und Mitteilung wie bei „notification“, **selbst im „Nicht stören“‑Modus**
- Ton: Laut und durchdringend, auch wenn das Gerät stumm ist oder DND aktiv
- Einsatz: Kritische Warnungen (Rauchmelder, Einbruch, medizinische Notfälle), bei denen man sofortige Aufmerksamkeit benötigt
- **`silent`**
- Anzeige: **Kein** sichtbarer Banner, **kein** Ton, keine Badges
- Verarbeitung: Wird nur intern von der Companion App entgegengenommen und in Home Assistant verarbeitet
- Einsatz: Hintergrund‑Signale, Status‑Synchronisation, Updates ohne User‑Unterbrechung (z. B. Daten‑Refresh)
| "data": {
"push": {
"category": "alarm"
}
} |
| `push.interruption_level` | String
| - **`notification`** (Standard)
- Anzeige: Banner in der Mitteilungszentrale und auf dem Sperrbildschirm
- Ton: Spielt einen Ton ab, sofern das Gerät nicht stumm geschaltet ist und der User es erlaubt
- Einsatz: Allgemeine Hinweise, Status‑Updates, alles, was keine besondere Dringlichkeit hat
- **`alarm`**
- Anzeige: Banner und Mitteilung wie bei „notification“, **selbst im „Nicht stören“‑Modus**
- Ton: Laut und durchdringend, auch wenn das Gerät stumm ist oder DND aktiv
- Einsatz: Kritische Warnungen (Rauchmelder, Einbruch, medizinische Notfälle), bei denen man sofortige Aufmerksamkeit benötigt
- **`silent`**
- Anzeige: **Kein** sichtbarer Banner, **kein** Ton, keine Badges
- Verarbeitung: Wird nur intern von der Companion App entgegengenommen und in Home Assistant verarbeitet
- Einsatz: Hintergrund‑Signale, Status‑Synchronisation, Updates ohne User‑Unterbrechung (z. B. Daten‑Refresh)
| "data": {
"push": {
"category": "alarm",
"interruption\_level": "time-sensitive"
}
}
|
| `actions` | Array | Eine Liste von Aktionen, die in der Benachrichtigung angezeigt werden. | SIehe json Data
|
| `action` | String | Der interne Schlüssel für die Aktion, der in Automatisierungen verwendet wird, wenn die Schaltfläche gedrückt wird.
Das ist auch der Wert den wir dann auswerten.
| `"SNOOZE"` |
| `title` | String | Der Text des Button, der in der Benachrichtigung angezeigt wird. | `"Rauchmelder Stoppen"` |
| `icon` | String | (Optional) Ein Icon, das mit der Aktion verknüpft ist. iOS unterstützt dies, aber Android zeigt normalerweise keine Icons an. | `"mdi:bell-alert"` |