Guia geral de automações

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

Visão geral

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

Benefícios:

• Backup e sincronização automáticos de dados
• Nenhuma intervenção manual necessária
• Frequência de sincronização configurável
• Vários tipos de automação para diferentes casos de uso
• Operação em segundo plano (o app não precisa estar aberto)

Casos de uso:

• Backups automáticos na nuvem
• Integração com sistemas de automação residencial
• Integrações de API para aplicativos personalizados
• Plataformas de análise e visualização de dados
• Compartilhamento de dados de saúde com profissionais de saúde

Limitações:

• Acesso a dados de saúde: Os apps não podem acessar 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 do app e podem não ser executadas imediatamente se:
  • A Atualização em segundo plano estiver desativada para o app
  • O dispositivo estiver no Modo de baixa energia
  • O dispositivo ficou inativo por longos períodos
  • Os recursos do sistema estiverem restritos
  • Vários apps estiverem competindo por tempo de execução em segundo plano
• Agendamento: Relacionado ao processamento em segundo plano, o iOS também não permite que apps sejam executados em segundo plano em um horário específico. Mesmo definindo uma cadência de sincronização, não há garantia de que as automações serão executadas exatamente no horário indicado. O dispositivo deve estar desbloqueado e o iOS determinará quando a automação será executada em segundo plano. As automações também podem ser acionadas manualmente por:
  • Widget de automações: toque no ícone do widget para acionar a automação
  • Shortcuts — Executar automação: use a ação Executar automação para acionar uma automação configurada (consulte Agendar uma automação com Shortcuts)
  • Acionamento manual no app: vá até a automaçã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, automações elegíveis podem ser executadas novamente em cadência regular (cerca de a cada 60 segundos). O dispositivo permanece ativo durante o uso em primeiro plano para que a sincronização continue. O loop 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 ainda se aplicam quando o app não está em primeiro plano.

Desempenho

Lembre-se de que o iOS é otimizado para tarefas de curta duração em um dispositivo móvel com restrições de desempenho muito rígidas. Tarefas em segundo plano normalmente precisam ser concluídas em até 30 segundos e têm limite de memória que podem consumir. O Health Auto Export oferece grande flexibilidade e personalização, e isso exige entender como certas configurações afetam o desempenho do app e os resultados.

• Configuração: Automações que produzem grandes volumes de dados podem fazer o sistema encerrar o processo e impedir que automações sejam executadas em segundo plano. As configurações a seguir podem produzir grandes volumes de dados:
  • Automações configuradas para exportar todas as métricas de saúde.
    • Recomendação: selecione apenas métricas de saúde que tenham dados salvos no Apple Health e apenas os dados que você realmente pretende usar. Mesmo tipos de dados vazios afetam o desempenho. Você também pode dividir as métricas selecionadas em várias automações, o que facilita o processamento pelo sistema.
  • Automações que usam agrupamento temporal em segundos ou minutos, ou com Resumir dados desativado. Consultas tão detalhadas podem demorar muito e entrar em conflito com as limitações do sistema.
    • Recomendação: embora pareça ideal ter o máximo de detalhes, considere se esse nível de detalhe é necessário para cada métrica ou tipo de dado. Considere várias automações com configurações diferentes.
  • Ao exportar treinos ao ar livre, como ciclismo, corrida, trilha etc. com dados de rota, GPS e métricas de saúde associadas podem gerar payloads grandes.
• Tamanho do payload: Especialmente ao usar exportação por REST API, lembre-se de que payloads grandes podem causar erros no servidor. Certifique-se de que seu backend está configurado para lidar com payloads de possivelmente centenas de megabytes para evitar erros.
• Frequência de sincronização: Adicione o widget de automações à Tela de início para ajudar a garantir que as automações sejam executadas com sucesso em segundo plano (consulte o Guia de configuração do widget de automações).

Tipos de automação disponíveis

O Health Auto Export oferece vários tipos de automação, cada um pensado para casos de uso específicos:

REST API

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

Guia: Guia de automaçã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 às suas automações de casa inteligente.

Guia: Guia de automação Home Assistant

MQTT

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

Guia: Guia de automação MQTT

Dropbox

Faça backup automático dos dados de saúde no Dropbox. Os arquivos são organizados em pastas e podem ser acessados de qualquer dispositivo.

Guia: Guia de automação Dropbox

Google Drive

Faça backup automático dos dados de saúde no Google Drive. Arquivos CSV podem ser convertidos em Planilhas Google para visualização fácil.

Guia: Guia de automação Google Drive

iCloud Drive

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

Guia: Guia de automaçã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 automação Calendário

Criar sua primeira automação

1. Acesse a tela Exportações automatizadas na navegação principal
2. Toque em «Nova automação»
3. Selecione um tipo de automaçã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 salvar
7. Ative a automação

Fazer backup e restaurar suas automações

O Health Auto Export pode fazer backup das configurações das suas automações no iCloud Drive para que você possa restaurá-las em um novo dispositivo ou após reinstalar o app. Isso é separado dos dados de saúde que suas automações exportam.

• Onde ficam os backups: As configurações das suas automações são salvas como arquivos JSON no iCloud Drive, na pasta Auto Export/Automations (visível no app Arquivos).
• Quando os backups acontecem: Sempre que você salva uma automação (tocando em Atualizar ou ao sair da tela de edição), essa automação é salva em backup automaticamente.
• Ativar ou desativar: Abra uma lista de automações e vá em Configurações de automação, depois use Fazer backup no iCloud Drive. Está ativado por padrão. Se você desativar, será perguntado se deseja excluir os arquivos de backup existentes do iCloud Drive — suas automações permanecem no dispositivo de qualquer forma.

Restauração

Se você abrir Exportações automatizadas e ainda não tiver automações, mas houver backups disponíveis no iCloud Drive, aparece o botão Restaurar do iCloud Drive. Tocar nele traz suas automações de volta.

Algumas coisas a saber após a restauração:

• Reconecte suas contas: Para sua privacidade, tokens de login de serviços como Dropbox e Google Drive não estão incluídos nos backups. Após restaurar, reconecte esses serviços em cada automação.
• Reative as automações: Automações restauradas começam desativadas para que nada seja executado inesperadamente com configurações desatualizadas. Revise cada uma e ative-a quando estiver pronto.
• Restaurações parciais: Se algumas automações não puderem ser restauradas (por exemplo, um arquivo ainda não foi baixado, a chave de criptografia ainda não está disponível ou foi criada por uma versão mais recente do app), as demais ainda são restauradas e você verá quais foram ignoradas.

Observação: cabeçalhos de requisição e credenciais digitadas em uma automação (como uma senha de MQTT) são criptografados nos arquivos de backup do iCloud Drive. A restauração em um novo dispositivo requer o Chaveiro do iCloud para que o app possa descriptografá-los. Arquivos compartilhados/exportados manualmente permanecem como JSON simples sem criptografia.

Registros de atividade

Cada automação tem Registros de atividade com o histórico de execução.

1. Abra a automação e toque em Ver registros 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 uma etapa demorou mais que o esperado. Erros indicam que uma etapa falhou (envio, leitura do HealthKit, autenticação etc.).
4. Limpar (barra de ferramentas) remove apenas o histórico de atividade dessa automação, não os registros de diagnóstico de todo o app.
5. Compartilhar (barra de ferramentas) exporta o ZIP de diagnóstico completo dos Registros de eventos do app — o mesmo pacote de Ajustes → Avançado → Exportar registros de eventos. Consulte o Guia de registros de eventos do app.

Consultas lentas nos registros de atividade

• Se uma automação demora para buscar dados de saúde, os registros 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).
• Automações em tempo real usam agrupamento mais fino por design e podem registrar avisos de consulta lenta com mais frequência.

Aviso de configurações de exportação

Ao configurar uma automação de métricas de saúde (não Home Assistant), você pode ver um rodapé em Configuraçõ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. Ele vincula a este guia. Avisos de consulta lenta nos registros 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, então os dados podem sincronizar com mais frequência
  • Com o Espelhamento do iPhone, o dispositivo se comporta como se estivesse desbloqueado. Assim o Health Auto Export pode acessar dados de saúde para executar ações automatizadas

2. Frequência de sincronização:

• Equilibre dados atualizados e uso 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 tempo de processamento e tamanho dos dados
• Considere automações separadas para grupos de métricas diferentes

4. Testes:

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

5. Monitoramento:

• Revise os registros de atividade regularmente
• Verifique os indicadores de status das automações
• Configure notificações para automações importantes
• Monitore o destino para confirmar o recebimento dos dados

6. Segurança:

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

7. Desempenho:

• Use agrupamento temporal adequado
• Considere o intervalo de datas para armazenamento em nuvem
• Monitore uso de bateria e dados
• Revise os registros de atividade em busca de avisos de consulta lenta

8. Estratégia de backup:

• Use vários tipos de automação para redundância
• Combine armazenamento em nuvem com integrações de API
• Mantenha backups locais quando possível
• Teste procedimentos de restauração

9. Solução de problemas:

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

Widget de automações

Adicione o widget «Automações» à Tela de início para:

• monitorar o status das automações rapidamente
• acionar automações manualmente
• otimizar envios em segundo plano

Obter ajuda

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

1. Consulte o guia dessa automação
2. Verifique os registros de atividade em busca de mensagens de erro
3. Consulte as seções de solução de problemas
4. Entre em contato com o suporte se os problemas persistirem