# Home Assistant push notification dengan rest_command: kebocoran, mesin cuci, pintu

> Kirim alert Home Assistant ke ponsel mana pun dengan satu rest_command, tingkat prioritas dari critical sampai low, dan tombol yang menutup katup air langsung dari notifikasi.

*23.10.2026*

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

Aplikasi Home Assistant Companion menangani notifikasi dengan baik bagi Anda yang menjalankan Home Assistant. Masalahnya muncul ketika orang yang seharusnya tahu tentang kebocoran di ruang bawah tanah adalah pasangan Anda yang tidak pernah memasang aplikasinya, orang tua, atau tetangga yang memegang kunci cadangan Anda. Memberi mereka akun Home Assistant hanya agar mereka menerima satu push notification adalah akses yang melebihi kebutuhan mereka.

Ada juga masalah kebisingan. "Mesin cuci selesai" dan "air di lantai kamar mandi" tidak seharusnya terdengar sama, dan jika alert server Anda sudah masuk lewat aplikasi lain, Anda harus memeriksa dua aliran notifikasi.

Panduan ini menggunakan `rest_command` Home Assistant untuk mengirim push notification melalui Pocket Alert. Tidak perlu add-on atau integrasi kustom, dan panduan ini membahas tiga automasi: kebocoran air pada level critical, mesin cuci selesai pada level low, dan pintu terbuka saat tidak ada orang di rumah.

## Yang Anda butuhkan

- Home Assistant dengan akses ke `configuration.yaml` (add-on File editor atau Studio Code Server, atau SSH).
- Akun Pocket Alert, kunci API dari [API Keys](/account/apikeys), dan aplikasi di ponsel yang akan menerima alert, [iPhone atau Android](/get-app). Paket gratis mencakup 50 pesan per hari untuk satu perangkat.

## rest_command

Simpan kunci di `secrets.yaml`, di folder yang sama dengan `configuration.yaml`:

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

Lalu tambahkan satu command ke `configuration.yaml`:

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

Mulai ulang Home Assistant. Sekarang Anda memiliki action bernama `rest_command.pocketalert`, dan apa pun yang Anda berikan di `data`-nya menjadi variabel template: `title`, `message`, `level` opsional, dan tombol opsional.

Mengapa JSON dibangun dengan `to_json` alih-alih ditulis manual? Nama sensor yang mengandung tanda kutip akan merusak string yang ditulis manual, dan `to_json` akan meng-escape-nya untuk Anda. API Pocket Alert hanya menerima JSON, dan itulah alasan `content_type` diatur: tanpanya, permintaan dikirim tanpa content type JSON.

Uji dari **Developer tools → Actions**: pilih `rest_command.pocketalert`, beralih ke mode YAML, dan jalankan:

```yaml
action: rest_command.pocketalert
data:
  title: "Hello from Home Assistant"
  message: "rest_command works"
```

Push seharusnya tiba dalam satu atau dua detik.

## Tiga automasi

Tambahkan ini di editor automasi (**Edit in YAML**) atau di `automations.yaml`. Ganti entity ID dengan milik Anda.

### Kebocoran air: critical

```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` adalah level untuk hal-hal yang tidak bisa menunggu sampai pagi. Di iPhone, notifikasi ini berbunyi dengan volumenya sendiri meski tombol senyap aktif dan Jangan Ganggu menyala; di Android, notifikasi ini memakai channel terpisah yang melewati Jangan Ganggu dan mengambil alih layar. Critical termasuk dalam paket berbayar; di paket gratis, pesan yang sama tiba sebagai `high`, yang tetap lolos Fokus tetapi tidak lolos tombol senyap.

### Mesin cuci selesai: low

Tidak ada sensor "mesin cuci selesai", tetapi smart plug dengan pemantauan daya akan memberi tahu Anda: ketika konsumsi daya tetap di bawah beberapa watt selama beberapa menit, siklus sudah selesai.

```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` tiba dengan tenang, tanpa suara dan tanpa gangguan. Notifikasi ini ada dalam daftar ketika Anda melihat ponsel, dan itulah seberapa mendesak cucian basah. Sesuaikan `below` dan `for` dengan mesin Anda: beberapa mesin cuci berhenti sejenak selama satu atau dua menit di tengah siklus.

### Pintu terbuka saat tidak ada orang di rumah: high

State dari `zone.home` adalah jumlah orang di dalamnya, jadi `"0"` berarti semua orang sedang keluar.

```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` ditandai sebagai sensitif waktu di iPhone, sehingga tetap lolos Fokus dan ringkasan terjadwal. Baris pesan adalah template: nilai di `data` dirender sebelum dikirim ke command.

## Tombol yang menutup katup air

Alert kebocoran akan lebih berguna jika Anda bisa langsung bertindak. Notifikasi Pocket Alert dapat membawa hingga tiga [tombol aksi](/features/action-buttons), dan tombol `http` mengirim permintaan **langsung dari ponsel itu sendiri**. Pocket Alert tidak meneruskannya. Artinya, tombol dapat memanggil webhook Home Assistant yang tidak terbuka ke internet, selama ponsel bisa menjangkaunya.

Pertama, sebuah automasi yang menutup katup saat webhook-nya dipanggil:

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

Jika katup Anda muncul sebagai switch, gunakan `switch.turn_off` sebagai gantinya. Buat webhook ID panjang dan acak: webhook Home Assistant tidak memiliki autentikasi selain mengetahui ID-nya.

Kemudian tambahkan tombol ke automasi kebocoran:

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

`rest_command` di atas mengubah `button_url` menjadi action `http` dengan metode POST. Ketika tombol diketuk, ponsel mengirim permintaan di latar belakang tanpa membuka aplikasi.

URL mana yang harus digunakan:

- **Hanya di rumah:** alamat tempat ponsel Anda menjangkau Home Assistant melalui Wi-Fi. `local_only: true` menjaga webhook tetap tertutup dari internet. Utamakan alamat `https://` jika Anda memilikinya di jaringan Anda.
- **Dari mana saja:** kebocoran biasanya terjadi saat Anda sedang di luar. Dokumentasi Home Assistant mencatat bahwa webhook dengan `local_only` tetap berfungsi melalui webhook Home Assistant Cloud (Nabu Casa), jadi URL cloud itu adalah pilihan termudah. VPN di ponsel, seperti Tailscale atau WireGuard, juga berfungsi dengan alamat LAN.

Saran Home Assistant sendiri adalah jangan menempatkan action yang merusak atau berbahaya di balik webhook, misalnya membuka kunci pintu. Menutup katup air adalah arah yang aman; membukanya tidak, jadi jangan letakkan itu di tombol ponsel Anda. Ketukan kedua akan mengirim permintaan kedua, yang tidak berbahaya di sini karena menutup katup yang sudah tertutup tidak melakukan apa-apa.

Dua hal yang perlu diketahui tentang tombol. Fitur ini untuk paket berbayar dan akan dihapus dari pesan di paket gratis; alert-nya sendiri tetap tiba. Selain itu, baik iOS maupun Android menampilkan label Anda sendiri langsung di notifikasi, bahkan ketika aplikasi Pocket Alert ditutup (versi 2.0.1 atau lebih baru). Tombol juga disimpan bersama pesan di aplikasi, jadi Anda tetap bisa mengetuknya setelah banner hilang.

## Alert untuk orang yang tidak memakai Home Assistant

Orang yang menerima push hanya perlu aplikasi Pocket Alert. Ada dua cara untuk mengaturnya:

- **Akun mereka sendiri.** Mereka mendaftar gratis, membuat kunci API, dan mengirimkannya kepada Anda. Tambahkan command kedua, `pocketalert_family`, dengan kunci mereka di `secrets.yaml`, lalu panggil kedua command di automasi kebocoran. Alert server Anda tetap berada di akun Anda; mereka hanya melihat apa yang Anda kirim kepada mereka.
- **Perangkat kedua di akun Anda.** Paket berbayar mencakup beberapa perangkat. Tambahkan ponsel mereka, lalu buat salinan command dengan `"device_id": "THEIR_DEVICE_ID"` ditambahkan ke dict `body`, sehingga hanya alert rumah tangga yang dikirim ke sana.

Dengan cara apa pun, mereka mendapatkan alert kebocoran dengan level dan tombol yang sama tanpa akun di Home Assistant Anda.

## Satu aplikasi untuk rumah dan semua hal lainnya

Kunci API yang sama juga berfungsi untuk cron job, backup, pemeriksaan uptime, dan CI. Jika Anda menjalankan homelab, [alert Proxmox, NAS, dan backup](/use-cases/homelab-alerts) masuk ke aliran yang sama dengan sensor kebocoran, masing-masing dengan level sendiri, dan aplikasi dapat menyaring aliran berdasarkan level, sehingga dua yang penting mudah ditemukan di antara empat puluh. Untuk sensor lain (board ESP32, Raspberry Pi, Node-RED), lihat [alert IoT dan sensor](/use-cases/iot-sensor-alerts).

Untuk perangkat yang hanya bisa mengirim webhook JSON, ada opsi tanpa kode: buat webhook di [konsol](/webhooks) dan buat template pesan dari payload-nya. Lihat [Webhook ke push](/tools/webhook).

## RESTful Notifications sebagai action notify

Jika Anda lebih suka action `notify.*`, platform RESTful Notifications Home Assistant juga dapat mengirim ke Pocket Alert:

```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` mengirim body JSON, `title_param_name` memetakan judul notifikasi ke field `title` kami, dan `data` menambahkan field tetap. Panggil dengan `action: notify.pocketalert` dan `title` serta `message`. Level ditetapkan per notifier, jadi buat satu untuk setiap level jika Anda membutuhkan beberapa, atau gunakan `rest_command`, yang juga menangani tombol.

## Jika tidak ada yang masuk

- **Periksa log.** `rest_command` mencatat peringatan dengan kode status ketika permintaan gagal. `401` berarti kunci di `secrets.yaml` salah; `400` biasanya berarti payload bukan JSON yang valid.
- **Mulai ulang saat pertama kali.** Blok `rest_command` pertama memerlukan restart Home Assistant sebelum action muncul; perubahan berikutnya dimuat dengan action `rest_command.reload`.
- **Jalankan action secara manual** dari Developer tools. Jika itu berhasil, masalahnya ada pada trigger atau kondisi automasi; periksa trace-nya.
- **Tombol tidak melakukan apa-apa:** buka host URL webhook dari browser ponsel. Jika ponsel tidak dapat menjangkau Home Assistant di alamat itu, tombol juga tidak bisa.
- **Periksa kuota hari ini.** Paket gratis berhenti di 50 pesan per hari, dan sensor yang terlalu sering mengirim bisa menghabiskannya. `for:` pada trigger membantu.

## FAQ

### Apakah saya perlu aplikasi Home Assistant Companion?

Tidak. Push berasal dari Pocket Alert, jadi ponsel hanya memerlukan aplikasi Pocket Alert. Anda tetap bisa menyimpan aplikasi Companion untuk sensor dan pelacakan lokasinya.

### Apakah ini berfungsi dengan Home Assistant Cloud?

Ya. `rest_command` memanggil API Pocket Alert langsung dari Home Assistant Anda, sehingga tidak bergantung pada Nabu Casa. Home Assistant Cloud hanya membantu tombol katup ketika Anda sedang berada di luar rumah.

### Bisakah alert kebocoran membangunkan saya di malam hari?

Pada `critical`, ya: notifikasi berbunyi melewati tombol senyap di iPhone dan melewati Jangan Ganggu di Android. Level itu memerlukan paket berbayar; di paket gratis, notifikasi tiba sebagai `high`.

### Apakah kunci API saya terekspos?

Kunci disimpan di `secrets.yaml` dan dikirim di header `Token` melalui HTTPS. Gunakan kunci terpisah untuk Home Assistant sehingga Anda bisa mencabutnya tanpa menyentuh skrip Anda yang lain.

[Buat akun gratis](/signup), tambahkan satu `rest_command`, dan biarkan rumah Anda memberi tahu Anda ketika membutuhkan perhatian Anda.
