Sincronizar dados do Apple Health com MQTT
Publique dados de saúde em um broker MQTT.
Última atualização: 31 de outubro de 2026
Nesta página
Configurações de exportação
Configurações de exportação Versão de exportaçãoIntervalo de datasResumir dados e agrupamento temporalPublique exportações de saúde como JSON em um 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 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 broker.
Permita as notificações quando solicitado. Essas notificações informam a atividade; não agendam uma execução.
Configurar a conexão
- Escolha MQTT como Tipo de automação.
- Digite o nome do host ou o endereço IP do broker e a porta. A porta padrão é 1883.
- Digite o Tópico, por exemplo
health/metrics. - Defina um ID do cliente exclusivo para cada automação e digite um nome de usuário e uma senha se o broker exigir.
O broker deve estar acessível a partir do seu dispositivo. Os assinantes devem usar o tópico exato, incluindo maiúsculas e minúsculas. Reutilizar um ID do cliente pode fazer com que as conexões do broker se substituam mutuamente.
Configuraçõ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 apps ou dispositivos específicos, abra Origens preferidas, escolha uma métrica e selecione 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 Salvar para aplicar as opções de origem ou Cancelar para descartá-las.
Treinos
Escolha Treinos para exportar registros de treino. Incluir dados de rota adiciona os pontos de rota disponíveis aos dados JSON do treino. Não cria arquivos 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 sempre inclui métricas do treino.
Configuraçõ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 |
|---|---|
| Padrão | O dia anterior e hoje até a hora da execução |
| Desde a última sincronização | Desde a sincronização anterior até a hora da execução |
| Hoje | Hoje até a 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 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, 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 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.
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.
- Conecte um assinante MQTT ao seu broker e assine 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 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}]
}
]
}
}
Solução de problemas
- Falha na conexão: Verifique o host, a porta, o acesso à rede e os requisitos de conexão do broker.
- Falha na autenticação: Verifique as credenciais e a permissão para publicar no tópico.
- Nenhuma mensagem: Confirme que o assinante usa o mesmo broker e o tópico exato e, em seguida, revise os registros de atividade.
- Mensagem grande demais: Selecione menos métricas, um intervalo mais curto ou um agrupamento temporal mais grosseiro.
Abra a automação e selecione Ver registros de atividade para revisar uma execução. Os avisos sinalizam possíveis problemas como uma recuperação de dados lenta; os erros identificam passos com falha. Para ajuda ao informar um problema, consulte Obter ajuda.