Pular para o conteúdo

Atalhos e App Intents

Exportar dados de saúde de ontem

Atalho sem parâmetros. O caminho rápido para exportar os dados de ontem. Usa o mesmo mecanismo da exportação manual. Parâmetro opcional Perfil (veja Perfis de exportação).

Exportar dados de saúde de uma data

Um parâmetro Data. A hora é ignorada. Útil em automações baseadas no calendário. Parâmetro opcional Perfil.

Exportar dados de saúde de um intervalo

Parâmetros Data inicial e Data final, ambas inclusivas. Use para preenchimentos retroativos. Parâmetro opcional Perfil.

Exportar os últimos N dias de dados de saúde

Parâmetro Número de dias (1–366). Termina ontem. Padrão: 7. Bom para automações semanais. Parâmetro opcional Perfil.

Obter resumo de saúde de uma data

Retorna uma captura estruturada — passos, calorias ativas, sono e frequência cardíaca — sem gravar no cofre.

Obter status da última exportação

Retorna data e hora, sucesso, número de dias e motivo de falha da exportação registrada mais recente. Uma solicitação com o dispositivo bloqueado permanece pendente até ser repetida e não aparece como status atual.

Ativar ou desativar exportação agendada

Parâmetro booleano. Suspenda o agendamento, por exemplo durante o Foco Férias, e retome depois.

Crie e gerencie perfis de exportação salvos no Health.md para iPhone ou Android. Nas plataformas Apple, o gerenciamento de perfis está documentado atualmente apenas para iPhone; não se afirma a disponibilidade no iPad nem no macOS.

Os quatro intents de exportação aceitam um parâmetro opcional Perfil. Quando há perfis, deixá-lo vazio usa o perfil ativo; no modo legado sem perfis, usa as configurações de exportação atuais do app. Passe o nome de um perfil salvo para executar a configuração congelada desse perfil — seleção de métricas, formatos e destino — independentemente do que o app mostra no momento.

Atenção para atalhos existentes sem parâmetro.

Assim que você criar seu primeiro perfil de exportação no app, um atalho sem Perfil definido exporta usando as configurações salvas do perfil ativo em vez das configurações atuais do app. Se você depende do comportamento antigo, fixe o atalho em um perfil específico (ou mantenha zero perfis) para continuar explícito. Um nome de perfil que não existe mais falha com um erro claro em vez de exportar a coisa errada.

## Onde encontrá-los

Abra o app Atalhos no iOS ou macOS. Toque em +, crie um atalho e busque "Health.md" ou um dos títulos acima. Eles ficam na categoria Saúde.

A maioria usa openAppWhenRun = false e é executada sem interface. Funciona em automações, filtros de Foco, transferência do Hey Siri e Botão de Ação.

Executar com o aparelho bloqueado não desbloqueia o HealthKit.

A Apple protege os dados enquanto o iPhone está bloqueado e remove o acesso dos apps cerca de dez minutos após o bloqueio. Permitir execução quando bloqueado permite iniciar a ação, mas não substitui a proteção do HealthKit. A permissão de conteúdo do Health.md nos Atalhos também não.

Se o HealthKit estiver indisponível, o Health.md preserva as datas como pendentes e envia uma notificação A exportação de saúde precisa de atenção. Desbloqueie o iPhone e toque nela ou abra o Health.md. Não é possível garantir uma exportação totalmente autônoma enquanto o telefone permanecer bloqueado.

  1. Automação pessoalHora do dia → escolha um horário em que o iPhone costuma estar desbloqueado, como 8:00 AM.
  2. Intent Exportar dados de saúde de ontem.
  3. Intent Obter status da última exportação.
  4. Mostrar notificação com o resultado.

Observação sobre status pendente: o status lê a entrada mais recente do histórico. Se o HealthKit estava bloqueado, pode mostrar a exportação anterior até a nova tentativa. A notificação de recuperação do Health.md é o sinal oficial.

  1. Crie um atalho.
  2. Exportar dados de saúde de um intervalo com início = 2024-01-01 e fim = 2024-12-31.
  3. Execute nos Atalhos. O app percorre o ano e grava um arquivo por dia. Anos completos podem levar alguns minutos.
  1. Filtro de Foco: quando o Foco Férias ativar, execute Ativar ou desativar exportação agendada com Enabled = false.
  2. Quando o Foco desativar, execute novamente com Enabled = true.
Autorização obrigatória.

Os intents herdam a permissão do HealthKit e a seleção do cofre no app. Eles falham com um erro claro se o app não tiver sido aberto e configurado pelo menos uma vez no dispositivo.