Zurück zum Blog

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

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: true hält den Webhook vor dem Internet verborgen. Nimm nach Möglichkeit eine https://-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_only trotzdem ü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_family hinzu, mit ihrem Schlüssel in secrets.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" zum body-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_command schreibt eine Warnung mit dem Statuscode, wenn die Anfrage fehlschlägt. 401 heißt, dass der Schlüssel in secrets.yaml falsch ist. 400 bedeutet 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 Aktion rest_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.

Artikel teilen