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

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, dan aplikasi di ponsel yang akan menerima alert, iPhone atau Android. Paket gratis mencakup 50 pesan per hari untuk satu perangkat.
rest_command
Simpan kunci di secrets.yaml, di folder yang sama dengan configuration.yaml:
pocketalert_token: "YOUR_API_KEY"
Lalu tambahkan satu command ke configuration.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:
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
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.
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.
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, 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:
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:
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: truemenjaga webhook tetap tertutup dari internet. Utamakan alamathttps://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_onlytetap 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 disecrets.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 dictbody, 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 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.
Untuk perangkat yang hanya bisa mengirim webhook JSON, ada opsi tanpa kode: buat webhook di konsol dan buat template pesan dari payload-nya. Lihat Webhook ke push.
RESTful Notifications sebagai action notify
Jika Anda lebih suka action notify.*, platform RESTful Notifications Home Assistant juga dapat mengirim ke Pocket Alert:
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_commandmencatat peringatan dengan kode status ketika permintaan gagal.401berarti kunci disecrets.yamlsalah;400biasanya berarti payload bukan JSON yang valid. - Mulai ulang saat pertama kali. Blok
rest_commandpertama memerlukan restart Home Assistant sebelum action muncul; perubahan berikutnya dimuat dengan actionrest_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, tambahkan satu rest_command, dan biarkan rumah Anda memberi tahu Anda ketika membutuhkan perhatian Anda.