Sincronizar dados do Apple Health com o Home Assistant
Integre seus dados de saúde com o Home Assistant.
Última atualização: 31 de outubro de 2026
Nesta página
Publique métricas de saúde no Home Assistant como estados de entidades separados. Este destino oferece suporte apenas a métricas de saúde.
Importante — limitações das automações: O dispositivo deve estar desbloqueado para ler dados de saúde, e o iOS não garante execuções em segundo plano na frequência que você escolher. Revise as limitações das automações antes de confiar em exportações automáticas.
Abrir a automação
Abra Exportar → Automatizado no iPhone, ou Automações na barra lateral do iPad. Selecione Nova Automação, ou abra uma existente para editá-la.
Nome, status e notificações
Digite um nome que identifique esta automação. Ativado permite execuções automáticas; deixe desativado até estar pronto.
Escolha as notificações de execução que quiser:
- Notificar ao atualizar o cache indica que os dados de exportação foram preparados.
- Notificar ao executar indica uma publicação bem-sucedida no Home Assistant.
Permita as notificações quando solicitado. Essas notificações informam a atividade; não agendam uma execução.
Conectar o Home Assistant
- Escolha Home Assistant como Tipo de automação.
- Digite a URL base da sua instância do Home Assistant, por exemplo
http://homeassistant.local:8123. - Crie um token de acesso de longa duração no seu perfil do Home Assistant.
- Em Cabeçalhos HTTP, adicione
Authorizationcom o valorBearer YOUR_LONG_LIVED_ACCESS_TOKEN.
Sua instância do Home Assistant deve estar acessível a partir do iPhone ou iPad. Para HTTPS, use um certificado em que o dispositivo confie.
Configurações de métricas de saúde
Abra Selecionar métricas de saúde e escolha as leituras a publicar.
Abra Origens preferidas para selecionar as origens de cada métrica. Use Todas para todas as origens não excluídas, ou Origens excluídas para ignorar uma origem nesta automação. As exclusões têm prioridade, e as origens não selecionadas não substituem uma origem preferida sem dados. Selecione Salvar para aplicar as opções ou Cancelar para descartá-las.
Configurações de exportação
O Home Assistant usa seu próprio formato JSON de estado de entidade; não há escolha de formato de arquivo nem de versão de exportação.
Intervalo de datas
- Padrão: Inclui o dia anterior e hoje até a hora da execução.
- Hoje: Inclui hoje até a hora da execução.
- Ontem: Inclui o dia anterior completo.
Agrupamento temporal
Escolha Padrão para manter as leituras sem agrupamento ou Dias para usar resumos diários. O Home Assistant não tem o interruptor Resumir dados.
Agendar lembretes
Se quiser um aviso para desbloquear e abrir o app, ative Ativar lembretes. Escolha Por hora, Todos os dias ou Dias selecionados e configure o minuto, a hora e os dias conforme apropriado. Permita o acesso a notificações quando solicitado; se for negado, use Abrir as configurações de notificações.
Um lembrete não executa a automação nem confirma uma sincronização bem-sucedida. Toque nele para abrir a automação, ou use Abrir e sincronizar na notificação para solicitar uma execução. A automação deve estar habilitada; um lembrete pode aparecer mesmo após uma execução em segundo plano bem-sucedida. As alterações de lembrete são aplicadas ao salvar.
Frequência de sincronização e salvar
Escolha um número e Minutos ou Horas em Frequência de sincronização. É uma cadência desejada em segundo plano, não um horário garantido.
O dispositivo deve estar desbloqueado quando os dados de saúde forem lidos. Ative a Atualização em Segundo Plano para o Health Auto Export e desative o Modo de Baixo Consumo para as execuções automáticas. O iOS pode atrasar as execuções se o dispositivo estiver inativo ou os recursos do sistema forem limitados.
Ative Ativado quando estiver pronto para execuções automáticas e selecione Atualizar para salvar a automação. Você pode carregar imediatamente um intervalo de datas com os passos seguintes.
Entidades publicadas
Cada métrica selecionada pode produzir uma ou mais entidades. O identificador começa com hae., seguido do nome da automação em minúsculas sem espaços, depois a métrica e qualquer nome de componente.
Por exemplo, uma automação chamada Health Metrics pode publicar passos em:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
O estado é a leitura mais recente do dia selecionado, com atributos de unidade de medida. Métricas como pressão arterial e frequência cardíaca usam entidades de componente separadas.
Quando um dia não tem dados, totais como passos e horas em pé publicam 0. Outras leituras, como peso ou frequência cardíaca, não são atualizadas até haver dados, assim o Home Assistant pode continuar mostrando o último valor recebido. No início do dia, os totais podem permanecer em 0 até os dados do Apple Watch chegarem ao iPhone.
Exportar dados históricos ou omitidos
Use Carga manual ao configurar pela primeira vez a automação para exportar dados históricos, ou mais tarde para cobrir datas que a sincronização automática não alcançou. Você também pode usá-la para verificar a configuração.
- Abra a automação e selecione Carga manual em Exportar dados existentes.
- Defina as datas de Início e Fim e selecione Iniciar exportação.
- No Home Assistant, abra Ferramentas do desenvolvedor → Estados e pesquise o prefixo
hae.da sua automação. - Verifique os valores das entidades e os horários de atualização.
Solução de problemas
- Erro de autenticação: Verifique o token e o cabeçalho
Authorization: Bearer .... - Falha na conexão: Verifique a URL base, a porta, o acesso à rede e a confiança do certificado.
- Algumas leituras ausentes: Revise o dia selecionado, as origens e os registros de atividade. Uma execução pode atualizar algumas entidades enquanto outras falham.
Abra a automação e selecione Ver registros de atividade para verificar os passos com falha. Para suporte, consulte Obter ajuda.