Home Assistant

通過任意 Home Assistant notify.* 目標路由 Minara 提醒，支持移動推送、TTS、電子郵件、Pushover 等。

🟢 運行時就緒：通過 HA 的 notify.* 服務域發送即忘通知。僅支持發送：notify.* 為單次調用，不返回消息 ID，因此無法編輯。助手會緩衝 token，在最終確認時統一發送。

功能說明

任意 notify.* 目標，HA 均可路由：
- mobile_app_<device>：通過 HA 伴侶 App 推送至 iOS / Android
- alexa_media_<device>：通過 Echo 設備播報
- google_assistant_sdk：通過 Google Home 播報 TTS
- pushover / telegram / discord，經 HA 集成代理轉發
- tts.* 服務：通過 HA 語音棧播報
- 自定義 notify.* 服務（在 YAML 中定義）
默認不綁定頻道。HA 服務負責路由消息；channel 覆蓋參數會被忽略（HA 服務 ID 在網關創建時設定）
軟限制 4 096 字符（助手默認值）；HA 本身無硬性上限

配置步驟

1. 創建長期訪問令牌

打開 Home Assistant 界面
點擊左下角頭像，進入 Long-lived access tokens
點擊 Create Token，命名為 "Minara"，複製令牌（僅顯示一次）

2. 選擇 notify 服務

在 HA 中，進入 Developer Tools 的 Services 頁，在服務選擇器中輸入 notify.，選擇一個可用服務。移動推送是常見起點：

notify.mobile_app_your_phone

在 HA 界面直接用測試消息觸發該服務，確認目標可達後再接入 Minara。

3. 配置 Minara

minara auth messaging add home_assistant

或直接編輯項目根目錄的 .env 文件：

HASS_URL=https://hass.example:8123
HASS_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
HASS_NOTIFY_SERVICE=mobile_app_your_phone

HASS_URL 填寫完整基礎 URL，末尾不加斜槓。HASS_NOTIFY_SERVICE 中的 notify. 前綴可省略，網關會自動處理。

4. 測試

minara auth messaging test home_assistant

測試消息會發送至所選 notify 目標。若選擇的是 Alexa TTS 服務，設備會朗讀消息內容；若選擇的是推送，手機會收到通知。

notify 路由示例

用途	`HASS_NOTIFY_SERVICE`	說明
手機推送（iOS/Android）	`mobile_app_<device>`	需安裝 HA 伴侶 App 並啟用推送
房間播報（Echo）	`alexa_media_<device>`	需安裝 alexa_media_player HACS 集成
Google Home TTS	`google_assistant_sdk`	需安裝 google_assistant_sdk 集成
Pushover 升級提醒	`pushover`	集成名稱：`notify.pushover_*`
轉發至 Telegram	`telegram`	已配置 HA → Telegram 時可用；Minara → HA → Telegram 多一層轉發，但可將路由邏輯集中在 HA 管理
廣播至分組	YAML 中定義的 `notify.grouped_alerts:` 扇出服務	在 `configuration.yaml` 中定義分組，然後在此引用

為何不支持頻道覆蓋

HA 路由到 notify 服務 ID，而非消息目標 ID。如需扇出，可在 HA 中創建 YAML 分組服務：

# configuration.yaml
notify:
  - platform: group
    name: grouped_alerts
    services:
      - service: mobile_app_pixel
      - service: alexa_media_kitchen

將 HASS_NOTIFY_SERVICE=grouped_alerts 後，單條 Minara 提醒即可扇出至所有服務。

常見問題

"401 Unauthorized"

HASS_TOKEN 有誤或已撤銷。在 HA 的 Profile 頁重新生成長期訪問令牌。

"404 Not Found"，提示服務未找到

HASS_NOTIFY_SERVICE 在當前 HA 實例中不存在。在 Developer Tools 的 Services 頁核查；notify 域僅顯示當前已註冊的服務。

"TLS error / certificate rejected"

HASS_URL 使用了自簽名證書。可將證書安裝到系統信任存儲，或通過 Caddy / Traefik / Cloudflare Tunnel 為 HA 配置正式證書。

"消息已到達 HA，但未收到通知"

移動 App：伴侶 App 未啟用推送，或設備處於勿擾模式。先在 HA 界面直接觸發相同服務排查：若同樣失敗，則問題在 HA 側。

參考

環境變量：HASS_URL、HASS_TOKEN、HASS_NOTIFY_SERVICE
源碼：apps/agent/src/messaging/home_assistant.ts
HA REST API：developers.home-assistant.io/docs/api/rest

本頁目錄