Home Assistant Push-Benachrichtigungen mit rest_command: Leck, Waschmaschine, Tür

Die Home Assistant Companion App eignet sich gut für Benachrichtigungen, wenn du selbst Home Assistant betreibst. Schwierig wird es, wenn die Person, die von einem Leck im Keller erfahren sollte, dein Partner ist, der die App nie installiert hat, ein Elternteil oder der Nachbar mit deinem Ersatzschlüssel. Ihnen einen Home Assistant-Account nur für eine einzige Push-Benachrichtigung zu geben, ist mehr Zugriff, als sie brauchen.
Dazu kommt das Lärmproblem. „Waschmaschine fertig“ und „Wasser auf dem Badezimmerboden“ sollten nicht gleich klingen. Und wenn deine Server-Alarme schon über eine andere App laufen, musst du zwei Kanäle im Blick behalten.
Diese Anleitung nutzt Home Assistants rest_command, um Push-Nachrichten über Pocket Alert zu senden. Du brauchst dafür kein Add-on und keine eigene Integration. Sie behandelt drei Automationen: ein Wasserleck mit kritischer Stufe, eine fertige Waschmaschine mit niedriger Stufe und eine Tür, die geöffnet wird, während niemand zu Hause ist.
Was du brauchst
- Home Assistant mit Zugriff auf
configuration.yaml(File-Editor- oder Studio-Code-Server-Add-on oder SSH). - Einen Pocket-Alert-Account, einen API-Schlüssel von API-Schlüssel und die App auf dem Handy, das die Alarme bekommen soll, iPhone oder Android. Der kostenlose Tarif umfasst 50 Nachrichten am Tag auf einem Gerät.
Das rest_command
Lege den Schlüssel in secrets.yaml im selben Ordner wie configuration.yaml ab:
pocketalert_token: "YOUR_API_KEY"
Füge dann in configuration.yaml einen Befehl hinzu:
rest_command:
pocketalert:
url: https://api.pocketalert.app/v1/messages
method: post
content_type: application/json
timeout: 10
headers:
Token: !secret pocketalert_token
payload: >-
{% set body = {"title": title, "message": message,
"level": level | default("default")} %}
{% if button_url is defined %}
{% set req = {"url": button_url, "method": "POST"} | to_json %}
{% set body = dict(body, actions=[{"type": "http",
"label": button_label | default("Run"), "value": req}]) %}
{% endif %}
{{ body | to_json }}
Starte Home Assistant neu. Jetzt gibt es eine Aktion namens rest_command.pocketalert. Was du in ihrem data-Feld übergibst, wird zur Template-Variable: title, message, optional level und optional ein Button.
Warum das JSON mit to_json statt von Hand aufgebaut wird? Ein Sensorname mit Anführungszeichen würde einen handgeschriebenen String kaputt machen, to_json maskiert ihn richtig. Die Pocket-Alert-API akzeptiert nur JSON, deshalb ist content_type gesetzt: Ohne diese Angabe geht die Anfrage ohne JSON-Content-Type raus.
Teste es unter Entwicklerwerkzeuge → Aktionen: Wähle rest_command.pocketalert, wechsle in den YAML-Modus und führe aus:
action: rest_command.pocketalert
data:
title: "Hello from Home Assistant"
message: "rest_command works"
Die Push-Benachrichtigung sollte innerhalb von ein bis zwei Sekunden ankommen.
Drei Automationen
Füge diese im Automationseditor (In YAML bearbeiten) oder in automations.yaml hinzu. Ersetze die Entitäts-IDs durch deine eigenen.
Wasserleck: kritisch
alias: "Leak under the sink"
triggers:
- trigger: state
entity_id: binary_sensor.kitchen_leak
to: "on"
actions:
- action: rest_command.pocketalert
data:
title: "Water leak: kitchen"
message: "The sensor under the sink is wet. Check it now."
level: critical
critical ist die Stufe für Dinge, die nicht bis zum Morgen warten können. Auf dem iPhone spielt sie mit eigener Lautstärke, auch über den Stummschalter und bei Nicht stören. Auf Android nutzt sie einen eigenen Kanal, der Nicht stören umgeht und den Bildschirm übernimmt. Kritisch ist Teil der kostenpflichtigen Tarife. Im kostenlosen Tarif kommt dieselbe Nachricht als high an, die zwar den Fokus durchbricht, aber nicht den Stummschalter.
Wäsche fertig: niedrig
Einen Sensor „Waschmaschine fertig“ gibt es nicht, aber eine Steckdose mit Leistungsmessung verrät es: Wenn die Leistungsaufnahme einige Minuten unter ein paar Watt bleibt, ist der Waschgang vorbei.
alias: "Washer finished"
triggers:
- trigger: numeric_state
entity_id: sensor.washer_plug_power
below: 5
for: "00:03:00"
actions:
- action: rest_command.pocketalert
data:
title: "Washer finished"
message: "Laundry is ready to hang."
level: low
low kommt leise an, ohne Ton und ohne Unterbrechung. Sie steht in der Liste, wenn du auf dein Handy schaust, und genau so dringend ist nasse Wäsche auch. Passe below und for an deine Maschine an: Manche Waschmaschinen pausieren mitten im Programm eine oder zwei Minuten.
Tür geöffnet, niemand zu Hause: hoch
Der Zustand von zone.home ist die Anzahl der Personen darin, "0" heißt also, dass alle unterwegs sind.
alias: "Front door opened while away"
triggers:
- trigger: state
entity_id: binary_sensor.front_door
to: "on"
conditions:
- condition: state
entity_id: zone.home
state: "0"
actions:
- action: rest_command.pocketalert
data:
title: "Front door opened"
message: "Opened at {{ now().strftime('%H:%M') }} and nobody is home."
level: high
high ist auf dem iPhone als zeitkritisch markiert, sie kommt also durch den Fokus und die geplante Übersicht. Die Nachrichtenzeile ist ein Template: Werte in data werden gerendert, bevor sie an den Befehl gehen.
Ein Button, der das Wasserventil schließt
Ein Leck-Alarm hilft mehr, wenn du gleich reagieren kannst. Pocket-Alert-Benachrichtigungen können bis zu drei Aktionsbuttons tragen, und ein http-Button sendet eine Anfrage direkt vom Handy aus. Pocket Alert leitet sie nicht weiter. Der Button kann also einen Home-Assistant-Webhook aufrufen, der nicht offen im Internet steht, solange das Handy ihn erreichen kann.
Zuerst eine Automation, die das Ventil schließt, wenn ihr Webhook aufgerufen wird:
alias: "Close main water valve (from push)"
triggers:
- trigger: webhook
webhook_id: "close-valve-9f2c41d7a3b8e605"
allowed_methods:
- POST
local_only: true
actions:
- action: valve.close_valve
target:
entity_id: valve.main_water
Wenn dein Ventil als Schalter erscheint, nutze stattdessen switch.turn_off. Mach die Webhook-ID lang und zufällig: Home-Assistant-Webhooks haben keine Authentifizierung außer der Kenntnis der ID.
Dann füge den Button zur Leck-Automation hinzu:
actions:
- action: rest_command.pocketalert
data:
title: "Water leak: kitchen"
message: "The sensor under the sink is wet."
level: critical
button_label: "Close water valve"
button_url: "https://ha.example.com/api/webhook/close-valve-9f2c41d7a3b8e605"
Das rest_command oben macht aus button_url eine http-Aktion mit der Methode POST. Tippst du auf den Button, sendet das Handy die Anfrage im Hintergrund, ohne die App zu öffnen.
Welche URL du nimmst:
- Nur zu Hause: die Adresse, unter der dein Handy Home Assistant im WLAN erreicht.
local_only: truehält den Webhook vor dem Internet verborgen. Nimm nach Möglichkeit einehttps://-Adresse, falls du eine in deinem Netz hast. - Von überall: Ein Leck passiert meist, wenn du unterwegs bist. Die Doku von Home Assistant weist darauf hin, dass Webhooks mit
local_onlytrotzdem über die Webhooks von Home Assistant Cloud (Nabu Casa) funktionieren. Damit ist die Cloud-URL die einfachste Option. Ein VPN auf dem Handy, etwa Tailscale oder WireGuard, funktioniert auch mit der LAN-Adresse.
Home Assistant rät selbst davon ab, zerstörerische oder unsichere Aktionen hinter einen Webhook zu legen, zum Beispiel das Entriegeln einer Tür. Ein Wasserventil zu schließen ist die sichere Richtung, zu öffnen nicht. Halte deshalb Letzteres von den Buttons auf deinem Handy fern. Ein zweiter Tipp sendet eine zweite Anfrage, was hier harmlos ist, denn ein bereits geschlossenes Ventil zu schließen bewirkt nichts.
Zwei Dinge zu Buttons: Sie sind ein Feature der kostenpflichtigen Tarife und werden im kostenlosen Tarif aus den Nachrichten entfernt. Der Alarm selbst kommt trotzdem an. Außerdem zeigen sowohl iOS als auch Android dein eigenes Label direkt in der Benachrichtigung, auch wenn die Pocket-Alert-App geschlossen ist (Version 2.0.1 oder neuer). Die Buttons werden zudem mit der Nachricht in der App gespeichert, sodass du sie auch nach dem Verschwinden des Banners noch antippen kannst.
Alarme für Leute ohne Home Assistant
Die Person, die die Push-Benachrichtigung bekommt, braucht nur die Pocket-Alert-App. Dafür gibt es zwei Wege:
- Ein eigener Account. Sie registrieren sich kostenlos, erstellen einen API-Schlüssel und schicken ihn dir. Füge einen zweiten Befehl
pocketalert_familyhinzu, mit ihrem Schlüssel insecrets.yaml, und rufe in der Leck-Automation beide Befehle auf. Deine Server-Alarme bleiben in deinem Account, sie sehen nur, was du ihnen schickst. - Ein zweites Gerät in deinem Account. Kostenpflichtige Tarife umfassen mehrere Geräte. Füge ihr Handy hinzu und lege dann eine Kopie des Befehls an, in der
"device_id": "THEIR_DEVICE_ID"zumbody-Dict hinzukommt, damit nur die Haushaltsalarme dort landen.
So oder so bekommen sie den Leck-Alarm mit derselben Stufe und demselben Button, ohne einen Account in deinem Home Assistant zu brauchen.
Eine App für das Haus und alles andere
Derselbe API-Schlüssel funktioniert für Cronjobs, Backups, Verfügbarkeitsprüfungen und CI. Wenn du ein Homelab betreibst, landen die Proxmox-, NAS- und Backup-Alarme im selben Verlauf wie der Leck-Sensor, jeweils mit eigener Stufe. Die App kann den Verlauf nach Stufe filtern, sodass die zwei wichtigen Meldungen unter vierzig leicht zu finden sind. Für weitere Sensoren (ESP32-Boards, ein Raspberry Pi, Node-RED) siehe IoT- und Sensor-Alarme.
Für Geräte, die nur einen JSON-Webhook senden können, gibt es eine Lösung ohne Code: Erstelle einen Webhook in der Konsole und baue die Nachricht aus dem Payload per Template. Siehe Webhook zu Push.
RESTful Notifications als notify-Aktion
Wenn du notify.*-Aktionen bevorzugst, kann die RESTful-Notifications-Plattform von Home Assistant ebenfalls an Pocket Alert senden:
notify:
- name: pocketalert
platform: rest
resource: https://api.pocketalert.app/v1/messages
method: POST_JSON
title_param_name: title
headers:
Token: !secret pocketalert_token
data:
level: high
POST_JSON sendet einen JSON-Body, title_param_name ordnet den Benachrichtigungstitel unserem Feld title zu, und data ergänzt feste Felder. Rufe sie mit action: notify.pocketalert auf und übergib title sowie message. Die Stufe ist pro Notifier fest. Wenn du mehrere brauchst, lege für jede Stufe einen eigenen an, oder bleib bei rest_command, das auch Buttons unterstützt.
Wenn nichts ankommt
- Prüfe das Protokoll.
rest_commandschreibt eine Warnung mit dem Statuscode, wenn die Anfrage fehlschlägt.401heißt, dass der Schlüssel insecrets.yamlfalsch ist.400bedeutet meist, dass der Payload kein gültiges JSON ist. - Beim ersten Mal neu starten. Der erste
rest_command-Block braucht einen Neustart von Home Assistant, bevor die Aktion erscheint. Spätere Änderungen lädst du mit der Aktionrest_command.reload. - Führe die Aktion von Hand aus unter Entwicklerwerkzeuge. Funktioniert das, liegt das Problem am Trigger oder an der Bedingung der Automation. Prüfe dann deren Trace.
- Der Button tut nichts: Öffne den Host der Webhook-URL im Browser des Handys. Erreicht das Handy Home Assistant unter dieser Adresse nicht, erreicht der Button es auch nicht.
- Prüfe das heutige Kontingent. Der kostenlose Tarif endet bei 50 Nachrichten am Tag, und ein geschwätziger Sensor kann das schnell aufbrauchen. Ein
for:am Trigger hilft.
FAQ
Brauche ich die Home Assistant Companion App?
Nein. Die Push-Benachrichtigung kommt von Pocket Alert, das Handy braucht also nur die Pocket-Alert-App. Du kannst die Companion App trotzdem für ihre Sensoren und die Standortverfolgung behalten.
Funktioniert das mit Home Assistant Cloud?
Ja. rest_command ruft die Pocket-Alert-API direkt von deinem Home Assistant aus auf, also hängt es nicht von Nabu Casa ab. Home Assistant Cloud hilft nur beim Ventil-Button, wenn du unterwegs bist.
Kann mich der Leck-Alarm nachts wecken?
Bei critical ja: Er ertönt auf dem iPhone über den Stummschalter und auf Android durch Nicht stören. Diese Stufe braucht einen kostenpflichtigen Tarif. Im kostenlosen Tarif kommt er als high an.
Ist mein API-Schlüssel ungeschützt?
Er liegt in secrets.yaml und wird im Token-Header über HTTPS gesendet. Nutze einen eigenen Schlüssel für Home Assistant, damit du ihn widerrufen kannst, ohne deine anderen Skripte anzufassen.
Erstelle ein kostenloses Konto, füge ein rest_command hinzu und lass dein Zuhause dich wissen, wenn es dich braucht.