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

> Sende Home Assistant-Alarme mit einem einzigen rest_command auf jedes Handy, mit Prioritätsstufen von kritisch bis niedrig und einem Button, der das Wasserventil direkt aus der Benachrichtigung schließt.

*23.10.2026*

<!-- source: https://pocketalert.app/de/blog/home-assistant-push-notifications -->

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](/account/apikeys) und die App auf dem Handy, das die Alarme bekommen soll, [iPhone oder Android](/get-app). 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:

```yaml
pocketalert_token: "YOUR_API_KEY"
```

Füge dann in `configuration.yaml` einen Befehl hinzu:

```yaml
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:

```yaml
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

```yaml
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.

```yaml
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.

```yaml
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](/features/action-buttons) 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:

```yaml
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:

```yaml
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](/use-cases/homelab-alerts) 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](/use-cases/iot-sensor-alerts).

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](/webhooks) und baue die Nachricht aus dem Payload per Template. Siehe [Webhook zu Push](/tools/webhook).

## RESTful Notifications als notify-Aktion

Wenn du `notify.*`-Aktionen bevorzugst, kann die RESTful-Notifications-Plattform von Home Assistant ebenfalls an Pocket Alert senden:

```yaml
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](/signup), füge ein `rest_command` hinzu und lass dein Zuhause dich wissen, wenn es dich braucht.
