도움말 센터 HealthyApps
한국어
도움말 센터
메인 웹사이트 ↗

도움말 검색

Home Assistant로 Apple Health 데이터 동기화

건강 데이터를 Home Assistant와 통합합니다.

최근 업데이트: 2026년 10월 31일

이 페이지에서
자동화 열기이름, 상태, 알림Home Assistant 연결건강 지표 설정
내보내기 설정 내보내기 설정 날짜 범위시간 그룹화
일정 알림동기화 빈도 및 저장게시되는 엔티티기록 또는 놓친 데이터 내보내기문제 해결

건강 지표를 개별 엔티티 상태로 Home Assistant에 게시합니다. 이 대상은 건강 지표만 지원합니다.

중요 — 자동화 제한 사항: 건강 데이터를 읽으려면 기기가 잠금 해제되어 있어야 하며, iOS는 선택한 빈도로 백그라운드 실행을 보장하지 않습니다. 자동 내보내기에 의존하기 전에 자동화 제한 사항을 확인하세요.

자동화 열기

iPhone에서는 보내기 → 자동화를, iPad에서는 사이드바의 자동화를 엽니다. 새 자동화를 선택하거나 기존 자동화를 열어 편집합니다.

이름, 상태, 알림

이 자동화를 식별하는 이름을 입력합니다. 활성화는 자동 실행을 허용합니다. 준비될 때까지 꺼 두세요.

필요한 실행 알림을 선택합니다:

  • 캐시 업데이트 시 알림은 내보내기 데이터 준비 완료를 보고합니다.
  • 실행 시 알림은 Home Assistant 게시 성공을 보고합니다.

요청되면 알림을 허용하세요. 이 알림은 활동만 보고하며 실행을 예약하지 않습니다.

Home Assistant 연결

  1. 자동화 유형으로 Home Assistant를 선택합니다.
  2. Home Assistant 인스턴스의 기본 URL을 입력합니다(예: http://homeassistant.local:8123).
  3. Home Assistant 프로필에서 Long-Lived Access Token을 만듭니다.
  4. HTTP 헤더 아래에 Authorization을 추가하고 값을 Bearer YOUR_LONG_LIVED_ACCESS_TOKEN으로 설정합니다.

Home Assistant 인스턴스는 iPhone 또는 iPad에서 도달 가능해야 합니다. HTTPS의 경우 기기가 신뢰하는 인증서를 사용하세요.

건강 지표 설정

건강 지표 선택을 열어 게시할 측정값을 고릅니다.

선호 소스를 열어 각 지표의 소스를 선택합니다. 제외되지 않은 모든 소스에는 모두를 사용하고, 이 자동화 전체에서 소스를 무시하려면 제외된 소스를 사용합니다. 제외가 우선하며, 선택하지 않은 소스는 데이터가 없는 선호 소스를 대체하지 않습니다. 저장으로 선택을 적용하고 취소로 버립니다.

내보내기 설정

Home Assistant는 자체 JSON 엔티티 상태 형식을 사용하므로 파일 형식이나 내보내기 버전 선택은 없습니다.

날짜 범위

  • 기본값: 전일과 실행 시각까지의 오늘을 포함합니다.
  • 오늘: 실행 시각까지의 오늘을 포함합니다.
  • 어제: 직전 하루 전체를 포함합니다.

시간 그룹화

측정값을 그룹화하지 않으려면 기본값, 일일 요약을 쓰려면 일을 선택합니다. Home Assistant에는 데이터 요약 토글이 없습니다.

일정 알림

잠금 해제와 앱 열기 안내가 필요하면 알림 사용을 켭니다. 매시간, 매일 또는 선택한 요일을 고른 뒤 필요에 따라 분, 시각, 요일을 설정합니다. 요청되면 알림 액세스를 허용하고, 거부된 경우 알림 설정 열기를 사용하세요.

알림은 자동화를 실행하지 않으며 동기화 성공도 확인하지 않습니다. 탭해 자동화를 열거나 알림의 열고 동기화로 실행을 요청합니다. 자동화가 활성화되어 있어야 합니다. 성공한 백그라운드 실행 후에도 알림이 나타날 수 있습니다. 알림 변경은 저장 시 적용됩니다.

동기화 빈도 및 저장

동기화 빈도에서 숫자와 분 또는 시간을 선택합니다. 이는 원하는 백그라운드 주기이며 보장된 일정이 아닙니다.

건강 데이터를 읽을 때 기기는 잠금 해제되어 있어야 합니다. Health Auto Export의 백그라운드 앱 새로 고침을 켜고 자동 실행을 위해 저전력 모드를 끄세요. 기기가 비활성 상태였거나 시스템 리소스가 제한되면 iOS가 실행을 지연할 수 있습니다.

자동 실행 준비가 되면 활성화를 켠 뒤 업데이트로 자동화를 저장합니다. 아래 단계로 선택한 날짜 범위를 바로 업로드할 수 있습니다.

게시되는 엔티티

선택한 각 지표는 하나 이상의 엔티티를 생성할 수 있습니다. 식별자는 hae.로 시작하고, 이어 공백 없는 소문자 자동화 이름, 지표, 선택적 구성 요소 이름이 옵니다.

예를 들어 Health Metrics라는 자동화는 걸음 수를 다음에 게시할 수 있습니다:

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

상태는 선택한 날의 최신 측정값이며 측정 단위 속성이 붙습니다. 혈압이나 심박수 같은 지표는 구성 요소별 별도 엔티티를 사용합니다.

그날 데이터가 없으면 걸음 수나 스탠드 시간 같은 합계는 0을 게시합니다. 체중이나 심박수 같은 다른 측정값은 데이터가 있을 때까지 업데이트되지 않으므로 Home Assistant는 마지막으로 받은 값을 계속 표시할 수 있습니다. 하루 초반에는 Watch 데이터가 iPhone에 도착할 때까지 합계가 0으로 남을 수 있습니다.

기록 또는 놓친 데이터 내보내기

자동화 최초 설정 시 기록 데이터를 내보내거나, 나중에 자동 동기화에서 놓친 날짜를 채우기 위해 수동 업로드를 사용합니다. 설정 확인에도 사용할 수 있습니다.

  1. 자동화를 열고 기존 데이터 내보내기 아래에서 수동 업로드를 선택합니다.
  2. 시작과 종료 날짜를 설정한 뒤 내보내기 시작을 선택합니다.
  3. Home Assistant에서 개발자 도구 → 상태를 열고 자동화의 hae. 접두사를 검색합니다.
  4. 엔티티 값과 업데이트 시각을 확인합니다.

문제 해결

  • 인증 오류: 토큰과 Authorization: Bearer ... 헤더를 확인하세요.
  • 연결 실패: 기본 URL, 포트, 네트워크 액세스, 인증서 신뢰를 확인하세요.
  • 일부 측정값 누락: 선택한 날, 소스, 활동 로그를 검토하세요. 실행이 일부 엔티티만 업데이트하고 다른 엔티티는 실패할 수 있습니다.

자동화를 열고 활동 로그 보기로 실패한 단계를 확인하세요. 지원은 도움말 받기를 참조하세요.