Sinkronkan Data Apple Health ke Home Assistant

Automatisasi Home Assistant memungkinkan Anda menyinkronkan data kesehatan secara otomatis ke Home Assistant sebagai state sensor. Integrasi ini memungkinkan Anda menggunakan data kesehatan dalam automasi Home Assistant, dashboard, dan integrasi lainnya.

Ringkasan

Automatisasi Home Assistant mengirimkan metrik kesehatan Anda ke REST API Home Assistant, membuat atau memperbarui state sensor yang dapat digunakan di seluruh instansi Home Assistant Anda. Data diformat khusus untuk API /states/<entity_id> Home Assistant.

Contoh penggunaan:

• Menampilkan metrik kesehatan di dashboard Home Assistant
• Membuat automasi berdasarkan data kesehatan
• Mengintegrasikan data kesehatan dengan perangkat smart home lainnya
• Melacak tren kesehatan dari waktu ke waktu di Home Assistant

Fitur utama:

• Pembuatan state sensor otomatis
• Hanya format JSON (dioptimalkan untuk Home Assistant)
• Hanya tipe data Health Metrics
• Konfigurasi URL sederhana

Keterbatasan

• Akses data kesehatan: Aplikasi tidak diizinkan mengakses data kesehatan saat iPhone terkunci. Automatisasi hanya berjalan saat perangkat Anda tidak terkunci. Ini dapat memengaruhi kesegaran data. Lihat petunjuk sinkronisasi manual agar data tetap mutakhir.

• Proses latar belakang: iOS membatasi proses latar belakang untuk menghemat baterai. Automatisasi bergantung pada Background App Refresh dan mungkin tidak langsung berjalan jika:

  • Background App Refresh dinonaktifkan untuk aplikasi
  • Perangkat dalam Mode Daya Rendah
  • Perangkat tidak aktif dalam waktu lama
  • Sumber daya sistem terbatas
  • Banyak aplikasi bersaing untuk waktu eksekusi latar belakang

• Hanya mendukung tipe data Health Metrics

• Hanya format JSON (tidak dapat diubah)

Prasyarat

• Instansi Home Assistant yang berjalan dan dapat diakses di jaringan Anda
• Token akses API Home Assistant (Long-Lived Access Token)
• Konektivitas jaringan ke instansi Home Assistant Anda
• Versi Home Assistant yang mendukung REST API

Konfigurasi

Buka layar Automated Exports dari navigasi utama, lalu ketuk "New Automation" dan pilih "Home Assistant" sebagai Automation Type.

Nama Otomatisasi

Masukkan nama deskriptif untuk otomatisasi Anda. Nama ini akan digunakan untuk menghasilkan ID entitas sensor di Home Assistant.

Catatan: Nama otomatisasi akan dikonversi menjadi huruf kecil tanpa spasi untuk membuat ID entitas. Misalnya, "My Health Data" menjadi hae.myhealthdata.

Notifikasi

Konfigurasikan kapan Anda ingin menerima notifikasi:

• Notify on Cache Update – Terima notifikasi saat data cache diperbarui
• Notify When Run – Terima notifikasi setiap kali otomatisasi dijalankan

URL Home Assistant

Masukkan URL dasar instansi Home Assistant Anda. Ini harus menyertakan protokol dan port jika tidak menggunakan default.

Contoh URL:

• http://homeassistant.local:8123
• http://192.168.1.100:8123

Catatan: URL harus dapat diakses dari perangkat Anda. Jika menggunakan HTTPS, pastikan sertifikat Anda valid atau tambahkan pengecualian.

Endpoint yang dibuat otomatis

Aplikasi secara otomatis menghasilkan endpoint API lengkap berdasarkan nama otomatisasi Anda:

{your_url}/api/states/hae.{automation_name}

Misalnya, jika URL Anda http://homeassistant.local:8123 dan nama otomatisasi Anda "Health Metrics", endpointnya akan menjadi:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Endpoint ini ditampilkan di bawah kolom URL sebagai referensi.

Request Timeout

Pilih interval batas waktu untuk permintaan HTTP ke Home Assistant.

Opsi batas waktu yang tersedia:

• 60 detik – Default, cocok untuk sebagian besar instansi Home Assistant
• 300 detik (5 menit) – Untuk instansi Home Assistant yang lebih lambat
• 1800 detik (30 menit) – Untuk pemrosesan yang sangat lambat
• 3600 detik (1 jam) – Batas waktu maksimum yang direkomendasikan

Header HTTP

Tambahkan header autentikasi untuk akses API Home Assistant. Anda perlu menambahkan header Authorization dengan Long-Lived Access Token Anda.

Header wajib:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Untuk mendapatkan Long-Lived Access Token:

1. Buka Home Assistant
2. Buka profil Anda (klik nama Anda di kiri bawah)
3. Gulir ke "Long-Lived Access Tokens"
4. Klik "Create Token"
5. Beri nama (misalnya "Health Auto Export")
6. Salin token dan tempel di kolom nilai header

Header opsional:
Anda dapat menambahkan header tambahan jika diperlukan untuk pengaturan Home Assistant Anda.

Untuk menambahkan header:

1. Ketuk "Add Headers"
2. Masukkan kunci header di kolom kiri
3. Masukkan nilai header di kolom kanan
4. Ulangi untuk header tambahan

Penting: Setiap kunci header harus memiliki nilai yang sesuai. Header kosong akan diabaikan.

Pengaturan jenis data

Data Type

Catatan: Automatisasi Home Assistant hanya mendukung tipe data Health Metrics. Pengaturan ini tidak dapat diubah dan secara otomatis diset ke Health Metrics.

Health Metrics Configuration

Select Health Metrics – Pilih metrik spesifik mana yang akan disertakan. Anda dapat memilih semua metrik yang tersedia atau hanya sebagian.

Tips: Memilih hanya metrik yang Anda perlukan dapat mempercepat pemrosesan dan mengurangi ukuran data yang dikirim ke Home Assistant.

Preferred Sources – Konfigurasikan sumber data mana yang diprioritaskan saat beberapa sumber menyediakan metrik yang sama.

Pengaturan ekspor

Export Format

Catatan: Automatisasi Home Assistant hanya mendukung format JSON. Pengaturan ini tidak dapat diubah dan secara otomatis diset ke JSON.

Export Version

Catatan: Export Version tidak tersedia untuk automatisasi Home Assistant karena format dioptimalkan khusus untuk state API Home Assistant.

Date Range

Pilih kapan data harus diekspor:

• Default – Menyinkronkan data untuk hari sebelumnya penuh ditambah data hingga tanggal dan waktu saat ini
• Today – Menyinkronkan semua data untuk tanggal saat ini hingga waktu saat ini
• Yesterday – Menyinkronkan semua data untuk hari sebelumnya penuh

Catatan: Automatisasi Home Assistant tidak mendukung opsi "Real Time", "Since Last Sync", atau "Previous 7 Days".

Summarize Data

Alihkan Summarize Data ON atau OFF untuk Health Metrics.

• ON – Menyediakan ringkasan data agregat (default)
• OFF – Menyediakan data tidak teragregasi jika memungkinkan

Catatan: Pengaturan ini hanya berlaku untuk tipe data Health Metrics.

Time Grouping

Saat Summarize Data diaktifkan, pilih cara data diagregasi:

• Default – Tanpa agregasi, titik data mentah
• Days – Mengelompokkan data per hari (direkomendasikan)

Frekuensi sinkronisasi

Konfigurasikan seberapa sering otomatisasi harus menyinkronkan data ke Home Assistant:

Pilih angka dan interval.

Pengujian dan verifikasi

Pengujian manual

1. Ketuk "Manual Export" di layar konfigurasi otomatisasi
2. Pilih rentang tanggal
3. Ketuk "Export" untuk mengirim permintaan uji
4. Periksa Home Assistant untuk memverifikasi state sensor dibuat/diperbarui

Memverifikasi di Home Assistant

1. Buka Home Assistant
2. Buka Developer Tools > States
3. Cari hae.{your_automation_name} (huruf kecil, tanpa spasi)
4. Pastikan state sensor menampilkan data kesehatan Anda
5. Periksa stempel waktu "Last Updated" untuk mengonfirmasi sinkronisasi terkini

Melihat Activity Logs

1. Ketuk "View Activity Logs" di layar konfigurasi otomatisasi
2. Tinjau jalannya otomatisasi terkini
3. Periksa error atau peringatan apa pun
4. Verifikasi stempel waktu permintaan dan status respons

Memeriksa log Home Assistant

Jika data tidak muncul di Home Assistant:

1. Buka Home Assistant
2. Buka Settings > System > Logs
3. Cari error terkait REST API atau state sensor
4. Periksa error autentikasi atau format data tidak valid

Pemecahan masalah

Masalah umum

Error autentikasi

• Pastikan Long-Lived Access Token Anda benar
• Pastikan header Authorization diformat sebagai: Bearer YOUR_TOKEN
• Periksa bahwa token belum kedaluwarsa atau dicabut
• Pastikan token memiliki izin yang sesuai di Home Assistant

Sensor tidak muncul di Home Assistant

• Periksa bahwa nama otomatisasi tidak berisi karakter khusus
• Verifikasi format ID entitas: hae.{automation_name} (huruf kecil, tanpa spasi)
• Periksa log Home Assistant untuk error
• Pastikan permintaan API berhasil (periksa Activity Logs)

Data tidak diperbarui

• Periksa bahwa otomatisasi diaktifkan
• Tinjau Activity Logs untuk error
• Pastikan konektivitas jaringan ke Home Assistant

Timeout koneksi

• Pastikan Home Assistant berjalan dan dapat diakses
• Periksa konektivitas jaringan
• Tingkatkan pengaturan Request Timeout jika Home Assistant lambat merespons
• Verifikasi URL dan port benar

Pesan error

Aplikasi akan menampilkan pesan error jika:

• URL tidak valid atau tidak dapat dijangkau
• Autentikasi gagal (periksa header Authorization)
• Home Assistant mengembalikan kode status error
• Konektivitas jaringan tidak tersedia

Periksa Activity Logs untuk informasi error detail termasuk kode status HTTP dan pesan error dari Home Assistant.

Tips integrasi Home Assistant

Menggunakan data kesehatan dalam automasi

Setelah data kesehatan Anda disinkronkan ke Home Assistant, Anda dapat menggunakannya dalam automasi:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Membuat dashboard

Tambahkan metrik kesehatan ke dashboard Home Assistant Anda:

1. Buka dashboard Anda
2. Tambahkan kartu baru
3. Pilih tipe kartu "Entities" atau "Gauge"
4. Tambahkan entitas sensor hae.{your_automation_name}

Struktur state sensor

State sensor di Home Assistant berisi:

• state: Nilai atau status saat ini
• attributes: Data tambahan termasuk:
  • Informasi stempel waktu
  • Struktur data yang cocok dengan format JSON yang diekspor
  • Informasi unit jika berlaku

Tips dan praktik terbaik

1. Sinkronisasi otomatis:

   • Isi daya perangkat Anda dan gunakan iPhone Mirroring
     • Saat perangkat sedang diisi daya, iOS memberi pembatasan lebih sedikit pada performa perangkat, sehingga data dapat disinkronkan lebih sering
     • Dengan iPhone Mirroring, perangkat Anda berperilaku seperti saat tidak terkunci. Ini berarti data kesehatan dapat diakses oleh Health Auto Export untuk menjalankan tindakan otomatis

2. Penamaan:

   • Hindari karakter khusus yang dapat menyebabkan masalah

3. Pemilihan data:

   • Pilih hanya metrik yang Anda perlukan