Sincronizar dados do Apple Health com o Home Assistant
Integre os 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 escolher. Reveja 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 a editar.
Nome, estado e notificações
Introduza 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 pretender:
- Notificar ao atualizar a 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. Estas notificações informam a atividade; não agendam uma execução.
Ligar o Home Assistant
- Escolha Home Assistant como Tipo de automação.
- Introduza o 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.
A 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.
Definiçõ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 Guardar para aplicar as opções ou Cancelar para as descartar.
Definições de exportação
O Home Assistant usa o seu próprio formato JSON de estado de entidade; não há escolha de formato de ficheiro nem de versão de exportação.
Intervalo de datas
- Predefinido: Inclui o dia anterior e hoje até à hora da execução.
- Hoje: Inclui hoje até à hora da execução.
- Ontem: Inclui o dia anterior completo.
Agrupamento temporal
Escolha Predefinido 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 pretender um aviso para desbloquear e abrir a aplicação, 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 definiçõ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 ativada; um lembrete pode aparecer mesmo após uma execução em segundo plano bem-sucedida. As alterações de lembrete são aplicadas ao guardar.
Frequência de sincronização e guardar
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 Poupança de Energia 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 guardar a automação. 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 a mostrar 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. Também a pode usar 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 programador → Estados e pesquise o prefixo
hae.da sua automação. - Verifique os valores das entidades e as horas de atualização.
Resolução de problemas
- Erro de autenticação: Verifique o token e o cabeçalho
Authorization: Bearer .... - Falha na ligação: Verifique o URL base, a porta, o acesso à rede e a confiança do certificado.
- Algumas leituras em falta: Reveja o dia selecionado, as origens e os registos de atividade. Uma execução pode atualizar algumas entidades enquanto outras falham.
Abra a automação e selecione Ver registos de atividade para verificar os passos com falha. Para suporte, consulte Obter ajuda.