Sincronizar dados do Apple Health com MQTT
Publique dados de saúde num broker MQTT.
Última atualização: 31 de outubro de 2026
Nesta página
Definições de exportação
Definições de exportação Versão de exportaçãoIntervalo de datasResumir dados e agrupamento temporalPublique exportações de saúde como JSON num tópico do seu broker MQTT.
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 broker.
Permita as notificações quando solicitado. Estas notificações informam a atividade; não agendam uma execução.
Configurar a ligação
- Escolha MQTT como Tipo de automação.
- Introduza o nome do anfitrião ou o endereço IP do broker e a porta. A porta predefinida é 1883.
- Introduza o Tópico, por exemplo
health/metrics. - Defina um ID do cliente exclusivo para cada automação e introduza um nome de utilizador e uma palavra-passe se o broker o exigir.
O broker deve estar acessível a partir do seu dispositivo. Os subscritores devem usar o tópico exato, incluindo maiúsculas e minúsculas. Reutilizar um ID do cliente pode fazer com que as ligações do broker se substituam mutuamente.
Definições do tipo de dados
Selecione um Tipo de dados para esta automação: Métricas de saúde, Treinos, Sintomas, ECG, Notificações de frequência cardíaca, Estado de espírito, Acompanhamento do ciclo ou Medicamentos. Estado de espírito exige iOS 18 ou posterior; Medicamentos exige iOS 26 ou posterior e acesso separado a medicamentos.
Métricas de saúde
Escolha Métricas de saúde, abra Selecionar métricas de saúde e selecione as medições de que precisar.
Para limitar as leituras a aplicações ou dispositivos específicos, abra Origens preferidas, escolha uma métrica e selecione as suas origens. Todas permite todas as origens que não foram excluídas. Use Origens excluídas para ignorar uma origem nas métricas de saúde desta automação. As exclusões têm prioridade; uma origem não selecionada não é substituída quando a preferida não tem dados. Selecione Guardar para aplicar as opções de origem ou Cancelar para as descartar.
Treinos
Escolha Treinos para exportar registos de treino. Incluir dados de rota adiciona os pontos de rota disponíveis aos dados JSON do treino. Não cria ficheiros GPX independentes.
Para a Versão 2, ative Incluir métricas do treino para adicionar leituras como frequência cardíaca, energia ativa e passos. Escolha Minutos ou Segundos para o Agrupamento temporal das métricas do treino; os segundos produzem mais detalhe e exportações maiores. A Versão 1 inclui sempre métricas do treino.
Definições de exportação
O MQTT publica apenas JSON. As mensagens usam QoS 0 para publicação em primeiro plano e QoS 1 para publicação em segundo plano. As mensagens não são retidas.
Versão de exportação
Escolha Versão 2 para a estrutura de dados atual. Use Versão 1 quando um fluxo existente depender do formato anterior.
Intervalo de datas
| Seleção | Dados incluídos |
|---|---|
| Predefinido | O dia anterior e hoje até à hora da execução |
| Desde a última sincronização | Desde a sincronização anterior até à hora da execução |
| Hoje | Hoje até à hora da execução |
| Ontem | O dia anterior completo |
| Últimos 7 dias | Os sete dias completos anteriores |
Resumir dados e agrupamento temporal
Para JSON + Métricas de saúde, ative Resumir dados para combinar leituras em grupos temporais, ou desative para leituras individuais quando disponíveis. O resumo depende da métrica—por exemplo, os passos são somados e as leituras de peso são mediadas. As exportações CSV de métricas de saúde usam dados resumidos.
Quando Agrupamento temporal estiver disponível, escolha quanto detalhe conservar. Os grupos por hora ou por dia produzem menos linhas do que os de minuto ou segundo. As opções disponíveis dependem do intervalo de datas e do formato. O agrupamento temporal de treinos é configurado separadamente em Treinos.
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, Horas, Dias ou Semanas em Frequência de sincronização—por exemplo, a cada 15 minutos. É 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.
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.
- Ligue um subscritor MQTT ao seu broker e subscreva o tópico configurado.
- No Health Auto Export, 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.
- Verifique o JSON recebido e as suas datas.
A carga útil segue o formato de exportação JSON. Por exemplo:
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Resolução de problemas
- Falha na ligação: Verifique o anfitrião, a porta, o acesso à rede e os requisitos de ligação do broker.
- Falha na autenticação: Verifique as credenciais e a permissão para publicar no tópico.
- Nenhuma mensagem: Confirme que o subscritor usa o mesmo broker e o tópico exato e, em seguida, reveja os registos de atividade.
- Mensagem demasiado grande: Selecione menos métricas, um intervalo mais curto ou um agrupamento temporal mais grosseiro.
Abra a automação e selecione Ver registos de atividade para rever uma execução. Os avisos assinalam possíveis problemas como uma recuperação de dados lenta; os erros identificam passos com falha. Para ajuda ao reportar um problema, consulte Obter ajuda.