Automações
Exporte dados do Apple Health para destinos que configurar, com limites em segundo plano, lembretes e definições partilhadas.
Última atualização: 31 de outubro de 2026
Nesta página
Definições de exportação comuns
Definições de exportação comuns Seleção de dadosFormato e versão de exportaçãoIntervalo de datasResumir dados e agrupamento temporalNotificações de execuçãoFazer cópia de segurança e restaurar as suas automações
Fazer cópia de segurança e restaurar as suas automações RestaurarAs automações exportam dados do Apple Health para destinos que configura. As execuções automáticas dependem do acesso aos dados de saúde da Apple e dos limites em segundo plano.
Criar ou editar uma automação
- No iPhone, abra Exportar → Automatizado. No iPad, abra Automações na barra lateral.
- Selecione Nova Automação, ou abra uma automação existente.
- Introduza um nome, escolha um destino e conclua a configuração com o guia correspondente.
- Escolha os dados e as definições de exportação de que precisar, ative Ativado e selecione Atualizar para guardar.
Pode voltar a uma automação incompleta para continuar a configurá-la.
Tipos de automação disponíveis
| Destino | O que faz |
|---|---|
| API REST | Envia exportações para um endpoint HTTP |
| Home Assistant | Publica métricas de saúde como estados de entidade |
| MQTT | Publica JSON num tópico do broker |
| Dropbox | Guarda ficheiros de exportação no Dropbox |
| Google Drive | Guarda ficheiros, com conversão opcional de CSV para Folhas de Cálculo |
| iCloud Drive | Guarda ficheiros de exportação no iCloud Drive |
| Calendário | Cria ou atualiza eventos do calendário |
| Envia exportações como anexos de e-mail |
Limitações
- Acesso a dados de saúde: As aplicações não podem aceder a dados de saúde enquanto o iPhone está bloqueado. As automações só são executadas quando o dispositivo está desbloqueado. É uma limitação imposta pela Apple que não pode ser contornada. Mais informações
- Processamento em segundo plano: O iOS limita o processamento em segundo plano para preservar a bateria. As automações dependem da Atualização em Segundo Plano e podem não ser executadas imediatamente se:
- A Atualização em Segundo Plano estiver desativada para a aplicação
- O dispositivo estiver no Modo de Poupança de Energia
- O dispositivo ficou inativo por longos períodos
- Os recursos do sistema estiverem restritos
- Várias aplicações estiverem a competir por tempo de execução em segundo plano
Agendamento
O iOS não garante execuções em segundo plano num horário específico. Para acionar uma automação no horário que escolher, consulte Agendar uma automação com Atalhos. O dispositivo deve estar desbloqueado quando a ação ler dados de saúde.
Frequência de sincronização
Escolha um número e uma unidade de tempo, por exemplo A cada 15 minutos, para definir a cadência desejada em segundo plano. Isto não garante que a aplicação abrirá ou será executada nesse intervalo. O iOS determina quando a execução em segundo plano está disponível.
Abrir a aplicação
As automações e Sincronizar com Mac são executadas enquanto o Health Auto Export permanece aberto.
Acionadores manuais
Pode iniciar uma execução com:
- Widget de automações: Toque no botão de nuvem no widget do Ecrã Principal. Consulte Widget de automações.
- Atalhos: Use Executar Automação para acionar uma automação configurada. Consulte Configuração de Atalhos.
- Na aplicação: Em Exportar dados existentes, selecione Carga manual, defina as datas de Início e Fim e selecione Iniciar exportação. Use isto para exportar dados históricos ao criar uma automação, cobrir datas que a sincronização automática não alcançou ou verificar a configuração.
Agendar lembretes
Cada automação pode opcionalmente lembrá-lo de desbloquear o dispositivo e abrir o Health Auto Export. Ative Ativar lembretes e, em seguida, defina Frequência do lembrete como Por hora, Todos os dias ou Dias selecionados. Os lembretes por hora usam Minuto da hora; os diários e de dias selecionados usam Hora do lembrete. Um lembrete não significa que a automação foi executada e pode aparecer mesmo após uma sincronização em segundo plano bem-sucedida.
- As alterações de lembrete entram em vigor depois que a automação é guardada. O editor mostra Próximo lembrete após guardar.
- Tocar no lembrete abre a automação.
- Abrir e sincronizar é uma ação na notificação. Abre a aplicação e executa imediatamente aquela automação. A automação deve estar ativada.
- Se a automação foi eliminada, está desativada, já está em execução ou não pode ser executada com o seu acesso atual, a aplicação volta ao ecrã Automações.
- É necessária a permissão de notificações para usar lembretes. Acesso a notificações mostra o estado atual. Se as notificações forem negadas, use Abrir as definições de notificações.
Definições de exportação comuns
Seleção de dados
Selecione um Tipo de dados e, em seguida, as métricas de saúde, tipos de treino ou sintomas a incluir. Os tipos de dados e formatos disponíveis dependem do destino. Consulte Dados compatíveis para a cobertura.
Para métricas de saúde, cada automação tem as suas próprias preferências de origem.
Para treinos, Incluir métricas do treino adiciona leituras selecionadas como frequência cardíaca ou passos. Incluir dados de rota inclui rotas disponíveis nos dados do treino. Consulte a referência do formato de treinos para a disponibilidade dos campos e o agrupamento temporal dos treinos.
Formato e versão de exportação
- JSON conserva dados estruturados para integrações.
- CSV é adequado para folhas de cálculo.
- Markdown cria notas e tabelas legíveis.
Home Assistant e MQTT usam JSON; Calendário cria eventos em vez de ficheiros. A conversão para Folhas de Cálculo Google aplica-se apenas às exportações CSV do Google Drive.
Use Versão 2 para a estrutura de exportação atual, ou Versão 1 quando um fluxo existente o exigir. Consulte JSON e Markdown para detalhes do formato.
Intervalo de datas
Dropbox, Google Drive, iCloud Drive e Calendário organizam os dados por Dia, Semana, Mês ou Ano. Cada período selecionado inclui leituras até ao fim, inclusive o último segundo.
API REST, MQTT e E-mail oferecem:
| Seleção | Período incluído |
|---|---|
| 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 |
| Últimos 7 dias | Os sete dias completos anteriores |
Home Assistant oferece Predefinido, Hoje e Ontem.
Resumir dados e agrupamento temporal
Nas exportações JSON de métricas de saúde, Resumir dados combina as leituras no Agrupamento temporal selecionado. Desative para leituras individuais quando disponíveis. As exportações CSV das automações usam dados resumidos. Os grupos temporais disponíveis dependem do destino e do intervalo de datas.
Para médias, totais e resumos diários por métrica, consulte Métricas de saúde.
Notificações de execução
Notificar ao atualizar a cache indica que os dados foram preparados; Notificar ao executar indica uma ação bem-sucedida no destino. São diferentes de Agendar lembretes, que pedem que abra a aplicação.
Verificar o estado da automação
Abra Ver registos de atividade na automação para rever as execuções. Enquanto as automações estiverem em execução, selecione Parar no ecrã Exportar ou Automações e confirme se quiser cancelar a execução.
Desempenho
Intervalos de datas amplos, muitas métricas selecionadas, rotas de treino detalhadas e leituras em nível de minuto ou segundo podem demorar mais e exceder o tempo ou os recursos disponíveis para uma execução em segundo plano.
- Selecione apenas os dados de que precisar.
- Use um intervalo de datas mais curto ou um agrupamento temporal mais grosseiro para exportações menores.
- Divida exportações grandes entre automações quando apropriado.
- Para cargas úteis REST grandes, considere Pedidos em lote.
Fazer cópia de segurança e restaurar as suas automações
O Health Auto Export pode fazer cópia de segurança das definições das suas automações no iCloud Drive para as restaurar num novo dispositivo ou após reinstalar a aplicação. Isto é independente dos dados de saúde que as suas automações exportam.
- Onde ficam as cópias de segurança: As definições são guardadas como ficheiros JSON no iCloud Drive, na pasta Auto Export/Automations (visível na aplicação Ficheiros).
- Quando as cópias de segurança acontecem: Cada vez que guarda uma automação (tocando em Atualizar ou saindo do ecrã de edição), essa automação é guardada automaticamente.
- Ativar ou desativar: Abra uma lista de automações, vá a Definições de automação e use Fazer cópia de segurança no iCloud Drive. Está ativado por predefinição. Se desativar, será perguntado se deseja eliminar os ficheiros de cópia de segurança existentes do iCloud Drive — as suas automações permanecem no dispositivo de qualquer forma.
Restaurar
Se abrir Automações e ainda não tiver nenhuma, mas houver cópias de segurança disponíveis no iCloud Drive, aparece o botão Restaurar do iCloud Drive. Tocá-lo recupera as suas automações.
Alguns pontos após a restauração:
- Religue as suas contas: Para a sua privacidade, os tokens de acesso de serviços como Dropbox e Google Drive não estão incluídos nas cópias de segurança. Após restaurar, religue esses serviços em cada automação.
- Reative as automações: As automações restauradas começam desativadas para que nada seja executado com definições desatualizadas. Reveja cada uma e ative quando estiver pronto.
- Restaurações parciais: Se algumas automações não puderem ser restauradas (por exemplo, um ficheiro ainda não foi descarregado, a chave de encriptação ainda não está disponível ou foi criada por uma versão mais recente da aplicação), o restante ainda é restaurado e verá quais foram omitidas.
Nota: Cabeçalhos de pedido e credenciais que introduziu numa automação (como uma palavra-passe MQTT) são encriptados nos ficheiros de cópia de segurança do iCloud Drive. Restaurar num novo dispositivo exige o Porta-chaves iCloud para que a aplicação possa desencriptá-los.
Registos de atividade
Abra uma automação e selecione Ver registos de atividade. Expanda uma execução para rever os seus eventos.
- Os avisos assinalam um possível problema, como uma recuperação de dados lenta; não confirmam que a execução inteira foi bem-sucedida.
- Os erros identificam passos com falha, como leitura de dados, autenticação ou carregamento.
- Limpar remove o histórico de atividade dessa automação.
- Partilhar exporta diagnósticos ao nível da aplicação para o suporte. Consulte Registos de eventos da aplicação.
Consultas lentas nos registos de atividade
Se uma execução reportar consultas lentas aos dados de saúde, selecione menos métricas, encurte o intervalo de datas ou ative Resumir dados e use um Agrupamento temporal mais grosseiro.
Widget de automações
Adicione um Widget de automações para verificar o estado ou acionar uma automação ativada a partir do Ecrã Principal. O iOS controla as oportunidades de atualização em segundo plano.
Obter ajuda
Consulte primeiro os registos de atividade e a secção de resolução de problemas do destino. Se ainda precisar de ajuda, consulte Obter ajuda.