Help Center ／ woowtech aiot App ／ 繁體中文
連線與通知故障排除
依序檢查網路、TLS、登入回呼、背景位置與通知，不先清空資料。
Wi-Fi 找不到主機
- 確認主機已開機，手機不是訪客/隔離網路。
- 用同一支手機瀏覽器開啟管理者提供的 Internal URL。瀏覽器也失敗，先處理主機或網路。
- 探索不到時可手動填入經核對的 URL。
homeassistant.local解析失敗時，由管理者確認內部 IP 或 DNS。 - 檢查 App 區域網路權限及 VLAN/multicast 限制，不需要停用整個防火牆。
在家正常，外出失敗
確認 External URL 不是區網 IP。用外部網路的瀏覽器測試相同 HTTPS 位址；需要 VPN 時先確認連線。請管理者檢查 DNS、TLS、WebSocket/反向代理，並確認 Internal 與 External 連到同一台 HA。不以購買 Cloud 訂閱或改用不安全 HTTP 作排障步驟。
憑證警告或登入未返回
核對網址、裝置日期、憑證有效期與信任鏈；不要略過 TLS 驗證。私人 CA/用戶端憑證需管理者依平台支援配置。
登入回呼必須與 App 版本、URL scheme 與 OAuth client metadata 一致。woowtech aiot 的新身份回呼是 woowtech://auth-callback；舊測試版本可能仍使用其他scheme。請提供 App 版本讓客服核對，不要分享含 code、state、token 的完整登入網址。同機有多款 App 時，確認返回正確產品。
位置與網路權限
辨識 Wi-Fi 網路與背景裝置追蹤是不同用途。系統可能要求位置/其他權限才能取得網路資訊；啟用裝置追蹤則依設定傳送資料到指定 HA。確認需要的用途，不要把所有定位/背景權限一律視為必要。
背景位置或 Sensors 不更新
- 確認對應 Sensor 已開啟且正在看正確裝置。
- 按需要檢查定位、精確位置、背景存取等權限。
- 檢查低耗電/電池最佳化與背景限制，只調整必要項目。
- 比較前景/背景、Wi-Fi/外部網路的時間與結果；系統可能限制更新，不能保證固定秒數即時回報。
畫面可用但收不到推播
- HA 前端的常駐通知不等於手機推播，需呼叫手機通知服務或由管理者建立轉送。
- 使用該裝置的
notify.mobile_app_*發送非敏感測試訊息，不猜 service 名稱。 - 檢查通知權限、Android頻道、專注/勿擾、鎖屏預覽及系統限制。
- APNs/FCM與品牌轉送服務、Local Push是不同路徑，需各自測試；可開儀表板不能證明推播鏈正常。
回報前準備
記錄 App/OS/HA版本、裝置型號、發生時間/時區、網路情境、最短重現步驟與已嘗試方式。截圖先遮蔽主機網址、帳號、家庭位置/影像、通知內容。不要刪除App資料或重設HA當作第一步，也不要傳密碼、token或完整備份。