Centro de ajuda HealthyApps
Português (Portugal)
Centro de ajuda
Site principal ↗

Pesquisar tópicos de ajuda

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
Abrir a automaçãoNome, estado e notificaçõesConfigurar a ligação
Definições do tipo de dados Definições do tipo de dados Métricas de saúdeTreinos
Definições de exportação Definições de exportação Versão de exportaçãoIntervalo de datasResumir dados e agrupamento temporal
Agendar lembretesFrequência de sincronização e guardarExportar dados históricos ou omitidosResolução de problemas

Publique 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

  1. Escolha MQTT como Tipo de automação.
  2. Introduza o nome do anfitrião ou o endereço IP do broker e a porta. A porta predefinida é 1883.
  3. Introduza o Tópico, por exemplo health/metrics.
  4. 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.

  1. Ligue um subscritor MQTT ao seu broker e subscreva o tópico configurado.
  2. No Health Auto Export, abra a automação e selecione Carga manual em Exportar dados existentes.
  3. Defina as datas de Início e Fim e selecione Iniciar exportação.
  4. 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.