Alerte Home Assistant pe iPhone

Home Assistant îți poate trimite deja notificări pe telefon: aplicația Companion instalează serviciul notify.mobile_app_…, iar pentru multe case asta e de ajuns.

Honk merită adăugat când casa nu e singurul lucru care îți trimite alerte. Alertele de acasă ajung în același inbox cu serverele și scripturile tale, un senzor care tot trece dintr-o stare în alta îți trimite o singură notificare, nu patruzeci, orele de liniște se setează pe proiect, iar o inundație te poate trezi totuși noaptea. Totul se face cu RESTful Command, integrarea inclusă în Home Assistant, deci nu ai nimic de instalat.

Înainte să începi

• Un cont Honk (deocamdată, doar pe bază de invitație: cere acces) și un proiect pentru casă, de exemplu „Acasă”, cu o cheie API: în aplicația web, deschide proiectul, apoi Chei.
• Acces la fișierele de configurare din Home Assistant.

1. Ține cheia în secrets.yaml

Cheia intră în secrets.yaml, cu cuvântul Bearer în față, ca să nu apară niciodată în configurația pe care o dai altora sau o salvezi în altă parte:

# secrets.yaml
honk_bearer: "Bearer honk_…"

2. Adaugă comenzile RESTful

Adaugă două comenzi în configuration.yaml: honk pentru text și honk_image pentru evenimente cu imagine. Conținutul cererii e construit cu to_json, așa că ghilimelele dintr-un mesaj nu pot strica cererea:

# configuration.yaml
rest_command:
  honk:
    url: "https://honk-me.app/v1/messages"
    method: POST
    content_type: "application/json"
    headers:
      Authorization: !secret honk_bearer
    payload: >-
      {{ dict(title=title, message=message, severity=severity | default('light'),
              priority=priority | default('normal'), group_key=group_key,
              event_type=event_type | default('event'),
              source='home-assistant', category='personal') | to_json }}
  honk_image:
    url: "https://honk-me.app/v1/messages"
    method: POST
    content_type: "application/json"
    headers:
      Authorization: !secret honk_bearer
    payload: >-
      {{ dict(title=title, message=message, severity=severity | default('light'),
              group_key=group_key, image_url=image_url,
              source='home-assistant', category='personal') | to_json }}

Repornește Home Assistant, apoi încearcă din Developer tools ▸ Actions:

# Developer tools ▸ Actions, in YAML mode
action: rest_command.honk
data:
  title: "Hello from Home Assistant"
  message: "If you can read this on your phone, it works."
  group_key: home/test

3. O alertă de inundație care își grupează repetările

Senzorii mai au toane. Un senzor de inundație care trece din ud în uscat și iar în ud într-un minut ar trebui să dea o singură alertă, nu trei. Dă tuturor alertelor despre același lucru același group_key și trimite-le ca problem: primul eveniment te anunță, repetările devin actualizări discrete, iar a doua automatizare raportează recovery după ce bucătăria a stat zece minute uscată, ceea ce închide incidentul.

# automations.yaml
- alias: "Honk: water leak in the kitchen"
  triggers:
    - trigger: state
      entity_id: binary_sensor.kitchen_leak
      to: "on"
  actions:
    - action: rest_command.honk
      data:
        title: "Water leak in the kitchen"
        message: "The sensor under the sink is wet."
        severity: blast
        event_type: problem
        group_key: home/leak/kitchen
- alias: "Honk: kitchen is dry again"
  triggers:
    - trigger: state
      entity_id: binary_sensor.kitchen_leak
      from: "on"
      to: "off"
      for: "00:10:00"
  actions:
    - action: rest_command.honk
      data:
        title: "Kitchen is dry again"
        message: "No water for 10 minutes."
        severity: beep
        event_type: recovery
        group_key: home/leak/kitchen

Un Claxon continuu pleacă cu prioritate Ridicată și poate porni pe ecranul de blocare o activitate live care rămâne acolo până arată „Revenit”. Ca să treacă noaptea de orele de liniște, trimite-l cu priority: urgent și permite mesajele urgente atât pe cheia API a proiectului, cât și în orele tale de liniște.

4. O sonerie cu imagine de la cameră

Soneria e cazul opus: fiecare apăsare trebuie să te anunțe. Dă-i fiecărei apăsări cheia ei de grup și atașează o captură de la cameră cu image_url:

- alias: "Honk: doorbell"
  triggers:
    - trigger: state
      entity_id: binary_sensor.doorbell
      to: "on"
  actions:
    - action: rest_command.honk_image
      data:
        title: "Someone is at the door"
        message: "Front door, {{ now().strftime('%H:%M') }}"
        # one group per ring, so every ring pushes
        group_key: "home/doorbell/{{ now().timestamp() | int }}"
        image_url: "https://example.ui.nabu.casa/api/camera_proxy/camera.front_door?token={{ state_attr('camera.front_door', 'access_token') }}"

Serverul Honk descarcă singur imaginea, după ce primește evenimentul, deci adresa trebuie să fie accesibilă din internet prin HTTPS, pe portul 443. Merge o adresă Home Assistant Cloud sau propriul tău reverse proxy HTTPS; o adresă homeassistant.local nu merge. Tokenul din proxy-ul camerei se schimbă la câteva minute, dar nu e o problemă, pentru că Honk descarcă imaginea în câteva secunde. O imagine poate avea cel mult 1 MB pe Free și 5 MB pe Pro și Team.

Ore de liniște pentru casă

În aplicația web Honk, deschide proiectul Acasă ▸ Notificările mele și setează orele de liniște, de exemplu de la 22:00 la 07:00. Un Claxon ușor despre mașina de spălat vase așteaptă până dimineață, iar la finalul orelor de liniște primești un singur rezumat. Orele de liniște sunt personale, așa că fiecare din casă și le poate alege pe ale lui.

Ce aduce Honk în plus

Aplicația Companion trimite fiecare notificare separat. Honk adaugă gruparea pentru senzorii gălăgioși, reveniri care închid o alertă, ore de liniște cu un rezumat dimineața, acțiuni pe Apple Watch și un singur inbox în care casa stă lângă tot ce mai administrezi.