Guia geral de automatizações

As automatizações permitem exportar e sincronizar automaticamente os seus dados do Apple Health para vários destinos sem intervenção manual. Este guia oferece uma visão geral da funcionalidade e ligações para guias detalhados de cada tipo de automatização.

Visão geral

As automatizações são fluxos de trabalho configurados que exportam automaticamente os seus dados de saúde para serviços externos, armazenamento na nuvem ou outros destinos. Depois de configuradas, podem ser executadas automaticamente em segundo plano.

Vantagens:

• Cópia de segurança e sincronização automáticas de dados
• Não é necessária intervenção manual
• Frequência de sincronização configurável
• Vários tipos de automatização para diferentes casos de utilização
• Funcionamento em segundo plano (a app não precisa de estar aberta)

Casos de utilização:

• Cópias de segurança automáticas na nuvem
• Integração com sistemas de automação residencial
• Integrações de API para aplicações personalizadas
• Plataformas de análise e visualização de dados
• Partilha de dados de saúde com profissionais de saúde

Limitações:

• Acesso a dados de saúde: As apps não podem aceder a dados de saúde enquanto o iPhone está bloqueado. As automatizaçõ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 automatizações dependem da Atualização em segundo plano da app e podem não ser executadas de imediato se:
  • A Atualização em segundo plano estiver desativada para a app
  • O dispositivo estiver no Modo de pouca energia
  • O dispositivo esteve inativo durante períodos prolongados
  • Os recursos do sistema estiverem restritos
  • Várias apps estiverem a competir por tempo de execução em segundo plano
• Agendamento: Relacionado com o processamento em segundo plano, o iOS também não permite que as apps sejam executadas em segundo plano a uma hora específica. Mesmo definindo uma cadência de sincronização, não há garantia de que as automatizações serão executadas exatamente à hora indicada. O dispositivo deve estar desbloqueado e o iOS determinará quando a automatização será executada em segundo plano. As automatizações também podem ser acionadas manualmente através de:
  • Widget de automatizações: toque no ícone do widget para acionar a automatização
  • Shortcuts — Executar automatização: use a ação Executar automatização para acionar uma automatização configurada (consulte Agendar uma automatização com Shortcuts)
  • Acionamento manual na app: vá à automatização no Health Auto Export e execute uma exportação manual
• Sincronização em primeiro plano: Enquanto o Health Auto Export está aberto em primeiro plano, automatizações elegíveis podem ser executadas novamente em cadência regular (cerca de a cada 60 segundos). O dispositivo permanece ativo durante a utilização em primeiro plano para que a sincronização continue. O ciclo em primeiro plano só pausa quando o dispositivo atinge o estado térmico crítico; em condições mais quentes (não críticas), a sincronização em primeiro plano ainda pode ser permitida. As limitações de agendamento em segundo plano acima continuam a aplicar-se quando a app não está em primeiro plano.

Desempenho

Tenha em conta que o iOS está otimizado para tarefas de curta duração num dispositivo móvel com restrições de desempenho muito apertadas. As tarefas em segundo plano normalmente têm de ser concluídas em 30 segundos e são limitadas na memória que podem consumir. O Health Auto Export oferece grande flexibilidade e personalização, pelo que é importante compreender como determinadas configurações afetam o desempenho da app e os resultados.

• Configuração: Automatizações que produzem grandes volumes de dados podem fazer com que o sistema termine o processo e impedir que as automatizações sejam executadas em segundo plano. As seguintes configurações podem produzir grandes volumes de dados:
  • Automatizações configuradas para exportar todas as métricas de saúde.
    • Recomendação: selecione apenas métricas de saúde que tenham dados guardados no Apple Health e apenas os dados que realmente pretende utilizar. Mesmo tipos de dados vazios têm impacto no desempenho. Também pode dividir as métricas selecionadas por várias automatizações, o que facilita o processamento pelo sistema.
  • Automatizações com agrupamento temporal em segundos ou minutos, ou com Resumir dados desativado. Consultas tão detalhadas podem demorar muito e colidir com as limitações do sistema.
    • Recomendação: embora pareça ideal ter o máximo de detalhe, considere se esse nível de detalhe é necessário para cada métrica ou tipo de dados. Considere várias automatizações com definições diferentes.
  • Ao exportar treinos ao ar livre, como ciclismo, corrida, caminhadas, etc. com dados de rota, o GPS e as métricas de saúde associadas podem produzir payloads grandes.
• Tamanho do payload: Especialmente ao usar exportação REST API, tenha em conta que payloads grandes podem causar erros no servidor. Certifique-se de que o seu backend está configurado para lidar com payloads de possivelmente várias centenas de megabytes para evitar erros.
• Frequência de sincronização: Adicione o widget de automatizações ao Ecrã principal para ajudar a garantir que as automatizações são executadas com sucesso em segundo plano (consulte o Guia de configuração do widget de automatizações).

Tipos de automatização disponíveis

O Health Auto Export suporta vários tipos de automatização, cada um pensado para casos de utilização específicos:

REST API

Envie dados de saúde para qualquer serviço web que aceite pedidos HTTP POST. Ideal para backends personalizados, webhooks e APIs de terceiros.

Guia: Guia de automatização REST API

Home Assistant

Sincronize métricas de saúde com o Home Assistant como estados de sensores. Perfeito para integrar dados de saúde nas suas automatizações de casa inteligente.

Guia: Guia de automatização Home Assistant

MQTT

Publique dados de saúde num broker MQTT. Ótimo para plataformas IoT e sistemas baseados em MQTT.

Guia: Guia de automatização MQTT

Dropbox

Faça cópia de segurança automática dos dados de saúde no Dropbox. Os ficheiros são organizados em pastas e podem ser acedidos a partir de qualquer dispositivo.

Guia: Guia de automatização Dropbox

Google Drive

Faça cópia de segurança automática dos dados de saúde no Google Drive. Os ficheiros CSV podem ser convertidos em Folhas de cálculo Google para visualização fácil.

Guia: Guia de automatização Google Drive

iCloud Drive

Guarde dados de saúde diretamente no iCloud Drive. Configuração simples sem autenticação adicional.

Guia: Guia de automatização iCloud Drive

Calendário

Crie eventos de calendário com base nos seus dados de saúde. Visualize treinos, marcos de saúde e outros eventos no calendário.

Guia: Guia de automatização Calendário

Criar a sua primeira automatização

1. Aceda ao ecrã Exportações automatizadas a partir da navegação principal
2. Toque em «Nova automatização»
3. Selecione um tipo de automatização
4. Configure as definições específicas do tipo (consulte os guias individuais)
5. Configure as definições comuns (tipo de dados, cadência de sincronização, etc.)
6. Toque em «Atualizar» para guardar
7. Ative a automatização

Cópia de segurança e restauro das suas automatizações

O Health Auto Export pode fazer cópia de segurança das definições das suas automatizações no iCloud Drive para que as possa restaurar num novo dispositivo ou após reinstalar a app. Isto é separado dos dados de saúde que as suas automatizações exportam.

• Onde ficam as cópias de segurança: As definições das suas automatizações são guardadas como ficheiros JSON no iCloud Drive, na pasta Auto Export/Automations (visível na app Ficheiros).
• Quando ocorrem as cópias de segurança: Sempre que guarda uma automatização (ao tocar em Atualizar ou ao sair do ecrã de edição), essa automatização é copiada automaticamente.
• Ativar ou desativar: Abra uma lista de automatizações e vá a Definições de automatização, depois use Cópia de segurança no iCloud Drive. Está ativado por predefinição. Se desativar, será perguntado se pretende eliminar os ficheiros de cópia de segurança existentes no iCloud Drive — as suas automatizações permanecem no dispositivo de qualquer forma.

Restauro

Se abrir Exportações automatizadas e ainda não tiver automatizações, mas existirem cópias de segurança disponíveis no iCloud Drive, aparece o botão Restaurar do iCloud Drive. Ao tocar nele, as suas automatizações são restauradas.

Algumas coisas a saber após o restauro:

• Volte a ligar as suas contas: Para a sua privacidade, os tokens de início de sessão de serviços como Dropbox e Google Drive não estão incluídos nas cópias de segurança. Após restaurar, volte a ligar esses serviços em cada automatização.
• Volte a ativar as automatizações: As automatizações restauradas começam desativadas para que nada seja executado inesperadamente com definições desatualizadas. Reveja cada uma e ative-a quando estiver pronto.
• Restauros parciais: Se algumas automatizações não puderem ser restauradas (por exemplo, um ficheiro ainda não foi transferido, a chave de encriptação ainda não está disponível ou foi criada por uma versão mais recente da app), as restantes são restauradas na mesma e verá quais foram ignoradas.

Nota: cabeçalhos de pedido e credenciais que introduziu numa automatização (como uma palavra-passe MQTT) estão encriptados nos ficheiros de cópia de segurança do iCloud Drive. O restauro num novo dispositivo requer o Chaveiro do iCloud para que a app os possa desencriptar. Os ficheiros partilhados/exportados manualmente permanecem como JSON simples sem encriptação.

Registos de atividade

Cada automatização tem Registos de atividade com o histórico de execução.

1. Abra a automatização e toque em Ver registos de atividade.
2. Os eventos são agrupados por execução (as mais recentes primeiro). Expanda uma execução para ver eventos individuais.
3. Avisos (por exemplo, consulta lenta de dados de saúde) indicam que a execução foi concluída, mas um passo demorou mais do que o esperado. Erros indicam que um passo falhou (carregamento, leitura do HealthKit, autenticação, etc.).
4. Limpar (barra de ferramentas) remove apenas o histórico de atividade dessa automatização, não os registos de diagnóstico de toda a app.
5. Partilhar (barra de ferramentas) exporta o ZIP de diagnóstico completo dos Registos de eventos da app — o mesmo pacote de Definições → Avançado → Exportar registos de eventos. Consulte o Guia de registos de eventos da app.

Consultas lentas nos registos de atividade

• Se uma automatização demora a obter dados de saúde, os registos de atividade podem mostrar avisos de consulta lenta de dados de saúde, não erros.
• Para acelerar as execuções: selecione menos métricas de saúde, use um intervalo de datas mais curto, ative Resumir dados e escolha um Agrupamento temporal maior (horas, dias ou semanas).
• Automatizações em tempo real usam agrupamento mais fino por conceção e podem registar avisos de consulta lenta com mais frequência.

Aviso de definições de exportação

Ao configurar uma automatização de métricas de saúde (não Home Assistant), pode ver um rodapé em Definições de exportação se a configuração puder ser lenta:

• Resumir dados está desativado, ou o agrupamento temporal é em minutos ou segundos, e
• Mais de 10 métricas de saúde estão selecionadas

O rodapé sugere menos métricas, intervalo de datas mais curto, Resumir dados ou agrupamento temporal mais grosso. Liga a este guia. Avisos de consulta lenta nos registos de atividade são separados e aparecem após uma execução quando as consultas excedem os limites.

Boas práticas

1. Sincronização automática:

• Carregue o dispositivo e use Espelhamento do iPhone
  • Durante o carregamento, o iOS impõe menos restrições de desempenho, pelo que os dados podem sincronizar com mais frequência
  • Com o Espelhamento do iPhone, o dispositivo comporta-se como se estivesse desbloqueado. Assim o Health Auto Export pode aceder a dados de saúde para executar ações automatizadas

2. Frequência de sincronização:

• Equilibre dados atualizados e utilização de recursos
• Sincronizações diárias funcionam bem na maioria dos casos
• Sincronizações mais frequentes para necessidades em tempo real
• Sincronizações menos frequentes para dados resumidos

3. Seleção de dados:

• Selecione apenas as métricas necessárias
• Reduz o tempo de processamento e o tamanho dos dados
• Considere automatizações separadas para grupos de métricas diferentes

4. Testes:

• Execute uma exportação manual
• Verifique se os dados aparecem no destino
• Consulte os registos de atividade em busca de erros
• Monitorize de perto as primeiras sincronizações

5. Monitorização:

• Revise os registos de atividade regularmente
• Verifique os indicadores de estado das automatizações
• Configure notificações para automatizações importantes
• Monitorize o destino para confirmar a receção dos dados

6. Segurança:

• Use métodos de autenticação seguros
• Mantenha as credenciais atualizadas
• Use HTTPS/TLS quando disponível
• Revise as definições de privacidade

7. Desempenho:

• Use agrupamento temporal adequado
• Considere o intervalo de datas para armazenamento na nuvem
• Monitorize a utilização da bateria e dos dados
• Revise os registos de atividade em busca de avisos de consulta lenta

8. Estratégia de cópia de segurança:

• Use vários tipos de automatização para redundância
• Combine armazenamento na nuvem com integrações de API
• Mantenha cópias locais quando possível
• Teste procedimentos de restauro

9. Resolução de problemas:

• Consulte primeiro os registos de atividade
• Verifique a conectividade de rede
• Verifique as credenciais de autenticação
• Consulte os guias de cada automatização para problemas específicos

Widget de automatizações

Adicione o widget «Automatizações» ao Ecrã principal para:

• monitorizar o estado das automatizações rapidamente
• acionar automatizações manualmente
• otimizar carregamentos em segundo plano

Obter ajuda

Se precisar de ajuda com um tipo de automatização específico:

1. Consulte o guia dessa automatização
2. Verifique os registos de atividade em busca de mensagens de erro
3. Consulte as secções de resolução de problemas
4. Contacte o suporte se os problemas persistirem