·15 min di lettura

Integrazione con l'app Salute: una guida pratica

Integrazione con l'app Salute: una guida pratica
Tradotto dall'ingleseLeggi l'originale

Maya ha 28 anni e sta cercando di capire se i suoi capogiri possano essere legati alla POTS. Dopo un episodio scorre il grafico della frequenza cardiaca sul suo Apple Watch e vede 142 bpm, poi 58 bpm, poi di nuovo 131 bpm. I numeri sono reali, ma non rispondono alle domande che deve affrontare con un cardiologo: l'aumento era legato al fatto di essersi alzata in piedi? Quanto è durato? Prima stava facendo attività fisica, si stava riprendendo da uno sforzo, era disidratata o dormiva?

Questo vuoto è il cuore dell'integrazione con l'app Salute. I dispositivi Apple possono raccogliere moltissime informazioni biometriche, ma le misurazioni grezze raramente si spiegano da sole. Un monitoraggio utile richiede un secondo livello che aggiunga tempistiche, contesto, riconoscimento degli schemi e un formato che anche un'altra persona possa esaminare.

Che cosa significa davvero integrazione con l'app Salute

L'integrazione con l'app Salute non è un singolo interruttore né una funzione isolata. Indica l'insieme dei collegamenti tecnici, basati sui permessi, che consentono alle app autorizzate di leggere dall'archivio dati alla base dell'app Salute e, in alcuni casi, di scriverci. Questo ecosistema comprende l'app Salute su iPhone, il framework HealthKit, i sensori di iPhone e Apple Watch e le app di terze parti che richiedono accessi specifici.

Apple ha presentato HealthKit alla WWDC il 2 giugno 2014 e ha poi reso disponibile al pubblico l'app Salute con iOS 8 il 17 settembre 2014. In seguito, nel suo Health Report, Apple ha descritto l'app Salute e Apple Watch, uscito nel 2015, come parti di una piattaforma più ampia che si è estesa costantemente a iPhone, iPad, Apple Watch e app compatibili. Questa storia conta, perché gli sviluppatori non si collegano a un esperimento appena nato: costruiscono su un livello di dati sanitari che esiste da molti anni.

Per Maya la distinzione importante è semplice:

  • Apple Watch rileva le misurazioni o contribuisce a fornirle.
  • HealthKit organizza queste misurazioni in modo sicuro sul dispositivo.
  • L'app Salute le offre un posto dove vedere le fonti e gestire i permessi.
  • Un'app specializzata può interpretare i dati selezionati e trasformarli in episodi, andamenti o report.

L'app Salute può mostrarle che la sua frequenza cardiaca è cambiata. Un'app di analisi può chiedersi se quei cambiamenti formano uno schema significativo.

Un diagramma che mostra come l'integrazione con l'app Salute aggiunga il contesto necessario ai dati grezzi sulla frequenza cardiaca rilevati da un Apple Watch.

Le misurazioni grezze sono solo il punto di partenza

Un valore di frequenza cardiaca ha senso solo insieme ai dettagli che lo circondano. L'ora della rilevazione, il fatto che la persona fosse in movimento, il valore di base precedente, la durata dell'aumento e i sintomi associati possono cambiare il modo in cui lo si interpreta.

Questo non significa che un'app possa diagnosticare una condizione da un grafico. Significa che l'integrazione può ridurre il lavoro manuale necessario per ricostruire una storia coerente. Invece di chiedere a Maya di ricordare ogni episodio, un'app in sola lettura può esaminare i campioni HealthKit autorizzati, individuare gli schemi e presentarle i risultati da verificare.

Regola pratica: l'app Salute conserva le prove. Un'app responsabile dovrebbe spiegare lo schema senza fingere che lo schema sia una diagnosi.

Come lavorano insieme HealthKit e l'app Salute

Pensa al sistema come a una biblioteca. L'app Salute è il bancone dell'accoglienza, dove vedi il tuo profilo, controlli le fonti e decidi a quali informazioni può accedere un'app. HealthKit sono gli scaffali e il catalogo che stanno dietro: il framework che conserva e organizza i campioni sanitari provenienti da app e dispositivi autorizzati.

L'analogia aiuta a distinguere due cose che spesso vengono considerate equivalenti. Aprire l'app Salute non significa che qualsiasi altra app possa vedere tutto ciò che vi è mostrato. Ogni app deve richiedere tipi di dati specifici, e iOS presenta queste richieste all'utente, che può approvarle o rifiutarle.

Il modello di dati dietro i grafici

HealthKit non tratta la frequenza cardiaca come un'unica linea indistinta. Conserva campioni suddivisi per tipo, come frequenza cardiaca, passi, analisi del sonno o dati sugli allenamenti. Un campione può contenere un'ora di inizio, un'ora di fine, il dispositivo di origine e altri metadati.

Questa struttura permette a un'app di porre domande mirate. Può richiedere i campioni di frequenza cardiaca in un certo intervallo di tempo, capire quale dispositivo li ha registrati o confrontare le rilevazioni con i periodi di allenamento. L'app non ottiene il permesso di girare liberamente per tutto l'archivio solo perché è stata autorizzata a leggere una categoria.

Un diagramma che illustra la differenza tra l'app Salute e HealthKit usando l'analogia di una biblioteca.

I permessi fanno parte dell'architettura

Apple spiega che i dati di HealthKit sono conservati sul dispositivo e crittografati, in modo che vi si possa accedere solo con il codice, Touch ID o Face ID dell'utente. Apple afferma inoltre che le metriche dell'app Salute vengono calcolate interamente sul dispositivo a partire dai dati dei sensori di Apple Watch e iPhone, come descritto nel suo white paper sulla privacy dei dati sanitari.

Un'app quindi passa attraverso due decisioni sui permessi. Prima deve dichiarare le categorie di dati che vuole usare. Poi sei tu a decidere quali delle categorie richieste consentire. Puoi rivedere o revocare queste scelte in seguito nelle impostazioni di Salute.

Lettura e scrittura sono permessi diversi

L'accesso in lettura consente a un'app di esaminare determinati campioni già presenti. L'accesso in scrittura le consente di aggiungere a HealthKit i campioni autorizzati. Un'app può richiedere l'uno, l'altro o entrambi.

Questa distinzione diventa importante quando devi decidere se fidarti. Un'app di monitoraggio che ha bisogno solo dei dati di frequenza cardiaca già esistenti non ha bisogno dell'accesso in scrittura per analizzarli. Più la richiesta è limitata, più è facile capire che cosa può fare l'app.

Quali dati possono leggere le app e perché la sola lettura è importante

HealthKit può rendere disponibili molte categorie di informazioni sanitarie, ma la loro disponibilità dipende dal dispositivo, dalla fonte, dai permessi concessi e dal modo in cui l'app richiede l'accesso. Un'app per il monitoraggio della frequenza cardiaca potrebbe richiedere frequenza cardiaca, variabilità della frequenza cardiaca, frequenza cardiaca a riposo, allenamenti o registrazioni ECG compatibili. Un'altra app potrebbe concentrarsi su sonno, passi, frequenza respiratoria, ossigeno nel sangue o cartelle cliniche, dove disponibili.

I permessi sono dettagliati. Puoi consentire a un'app di leggere la frequenza cardiaca e negarle i dati sul sonno, e l'app non può esaminare una categoria che non hai approvato. Lo stesso principio vale per la scrittura: un'app che può scrivere un tipo di dato non ottiene automaticamente il permesso di scrivere tutti gli altri.

Tipo di dato Lettura Scrittura
Frequenza cardiaca Sì Possibile con permesso
Variabilità della frequenza cardiaca Sì Possibile con permesso
Frequenza cardiaca a riposo Sì Possibile con permesso
Registrazioni ECG Dove supportato e autorizzato Limitata dal tipo di dato e dalle funzionalità dell'app
Ossigeno nel sangue Dove supportato e autorizzato Possibile solo se HealthKit lo consente per quel tipo di dato
Analisi e fasi del sonno Sì, dove disponibile Possibile con permesso
Passi Sì Possibile con permesso
Allenamenti Sì Possibile con permesso
Frequenza respiratoria Sì, dove disponibile Possibile con permesso
Cartelle cliniche Dove disponibile e autorizzato Dipende dal tipo di documento e dal supporto del framework

Perché un accesso più limitato aumenta la fiducia

Progettare un'app in sola lettura crea un confine significativo. Un'app con accesso in sola lettura può analizzare i dati esistenti, ma non può aggiungere campioni per far sembrare più completa una dashboard né modificare un registro per farlo combaciare con un'interpretazione. Non può nemmeno registrare una condizione che l'utente non ha mai inserito.

Questo confine è importante nel monitoraggio di POTS e disautonomia, perché la qualità delle conclusioni dipende dall'integrità della cronologia di partenza. Se un'app modifica i dati di origine, un'analisi successiva diventa meno affidabile. Un flusso in sola lettura lascia i dati originali nell'app Salute e colloca l'interpretazione in un livello separato.

Una domanda utile: l'app ha bisogno di scrivere qualcosa, o le basta capire ciò che l'app Salute contiene già?

La sola lettura non rende automaticamente un'app precisa o adatta all'uso clinico. Rende però più facile spiegare il flusso dei dati: l'app legge i campioni autorizzati, esegue l'analisi dichiarata e lascia a te il controllo su ciò che succede dopo.

Configurare l'integrazione con l'app Salute passo dopo passo

La configurazione inizia quando un'app come Cardiogram chiede di accedere all'app Salute. La schermata di autorizzazione del sistema elenca le categorie che l'app vuole leggere o scrivere. Non approvare la richiesta in automatico: controlla ogni categoria e concedi solo ciò che corrisponde allo scopo dell'app.

Parti dalla schermata di autorizzazione del sistema

Per l'analisi degli schemi della frequenza cardiaca, le richieste rilevanti possono includere:

  1. Frequenza cardiaca, che fornisce i campioni registrati in battiti al minuto.
  2. Variabilità della frequenza cardiaca, che può aggiungere un ulteriore segnale per l'analisi degli andamenti.
  3. Frequenza cardiaca a riposo, che aiuta a stabilire il tuo valore di base personale.
  4. Allenamenti, che forniscono il contesto per distinguere gli aumenti dovuti all'esercizio fisico da altri eventi.

L'app può usare solo le categorie che approvi. Se salti l'accesso al sonno o agli allenamenti, la sua analisi non potrà contare su quei dati di contesto.

Un'infografica in tre passaggi che mostra come l'app Cardiogram richiede e ottiene il permesso di accedere ai dati dell'app Salute.

Ricontrolla gli accessi dopo la configurazione

Puoi rivedere i permessi in Impostazioni > Privacy e sicurezza > Salute. La schermata nell'app e quella delle impostazioni di iOS hanno scopi diversi: la schermata di sistema iniziale concede l'accesso, mentre le impostazioni ti permettono di controllare o modificare la scelta in un secondo momento.

Attiva Aggiorna app in background se l'app si basa su aggiornamenti in background e consenti le notifiche se vuoi ricevere avvisi quando l'app individua un evento rilevante. Queste impostazioni non trasformano HealthKit in un flusso continuo in tempo reale, ma possono aiutare l'app a elaborare nuove informazioni quando il sistema operativo lo permette.

Per una procedura più dettagliata su come preparare i dati da far esaminare, leggi questa guida all'esportazione dei dati dall'app Salute.

Risolvere il problema dei dati mancanti

Se non compare nessun dato, controlla la fonte prima di dare per scontato che l'integrazione non funzioni:

  • Verifica il collegamento dell'orologio. Assicurati che Apple Watch sia abbinato all'iPhone giusto.
  • Controlla il rilevamento del polso. La raccolta dei dati dai sensori può risentirne se non indossi l'orologio o se il rilevamento del polso è disattivato.
  • Controlla le fonti in Salute. Apri la metrica che ti interessa nell'app Salute e verifica quali fonti forniscono i dati.
  • Ricontrolla i permessi. Un'app potrebbe avere accesso alla frequenza cardiaca ma non agli allenamenti o all'HRV.
  • Lascia il tempo per l'elaborazione. La consegna dei dati in background può subire ritardi, quindi un'app potrebbe non reagire subito a un nuovo campione.

Un esempio concreto per POTS e disautonomia

Immagina un'app in sola lettura che analizza i dati sulla frequenza cardiaca di una persona che ha capogiri dopo essersi alzata in piedi. L'app Salute fornisce i campioni di partenza. Il compito dell'app è disporli in una cronologia che risponda a domande più utili di "Qual era la mia frequenza cardiaca?".

Un flusso pensato per una specifica condizione può esaminare un valore di base, cercare un aumento consistente in un breve intervallo e registrare il picco e la durata dell'aumento. Cardiogram descrive il rilevamento automatico di aumenti di 30 bpm o più entro 5 minuti, registrando per ogni episodio orario, valore di base, picco e durata, così da poterli rivedere. Questo criterio è una regola di screening e monitoraggio, non una diagnosi, e deve essere interpretato da un medico insieme ai sintomi e alle altre informazioni cliniche.

Il contesto distingue gli schemi dal rumore

Un valore alto durante un allenamento non va trattato allo stesso modo di un aumento mentre sei in piedi in cucina. Per questo gli allenamenti e i periodi di recupero possono essere esclusi dal conteggio degli episodi, eliminando una causa frequente di avvisi fuorvianti.

Sonno, sintomi, idratazione, assunzione di sale, farmaci e contesto delle attività possono aggiungere un ulteriore livello. Una persona potrebbe annotare capogiri o palpitazioni vicino a un episodio e poi verificare se eventi simili si ripetono dopo aver dormito male o in determinati momenti della giornata. Il risultato non è una conclusione medica, ma un insieme di osservazioni più ordinato da discutere con il medico.

Per capire come i dati grezzi possano diventare schemi nel tempo, leggi questa guida all'analisi degli andamenti dei dati sanitari.

L'elaborazione sul dispositivo cambia il flusso di lavoro

Apple afferma che i dati di HealthKit restano protetti sul dispositivo, e le app possono essere progettate per leggere riepiloghi locali senza bisogno di accedere da un server allo storico dei dati sanitari grezzi. In un modello sul dispositivo, l'app analizza localmente i campioni autorizzati e sincronizza tramite il tuo iCloud, invece di inviare i dati grezzi ai server del produttore.

Il risultato può essere un riepilogo settimanale, una mappa di calore degli orari degli episodi o un PDF che indica il criterio di rilevamento e riassume episodi, sintomi e andamenti. Questo formato risolve il problema pratico che Maya aveva all'inizio. Il suo medico non ha bisogno di scorrere a lungo punti scollegati di un grafico: gli serve un resoconto sintetico che mostri che cosa è successo, quando è successo e quale contesto ha osservato la paziente.

Dove l'integrazione con l'app Salute ha ancora dei limiti

L'integrazione con l'app Salute può collegare diverse fonti di dati senza renderle automaticamente coerenti tra loro. L'app Salute viene spesso considerata un registro unificato, ma i dati possono comunque differire per tempistiche, copertura, metadati e priorità delle fonti.

Analisi indipendenti segnalano un limite importante: HealthKit non uniforma i dati tra wearable di marchi diversi e non offre indicatori integrati di andamento o di "prontezza". Chi usa più dispositivi può trovarsi con dati sovrapposti, lacune o misurazioni in contrasto. L'integrazione può funzionare dal punto di vista tecnico e lasciare comunque a te la decisione su quale fonte debba guidare un andamento.

I dati grezzi non diventano informazioni utili da soli

HealthKit fornisce campioni sanitari strutturati, non un livello di interpretazione specifico per una condizione. Non etichetta di per sé un episodio ortostatico, non spiega perché la frequenza cardiaca è aumentata e non produce un riepilogo dei sintomi della POTS pronto per il medico.

Questo lavoro spetta all'app che legge i dati. Se l'app non offre filtri adeguati, registrazione del contesto o report, resta a te il compito di trasformare un lungo storico in qualcosa che il tuo team di cura possa esaminare.

Il telefono resta il punto d'accesso pratico

Poiché HealthKit è progettato intorno all'archiviazione locale sul dispositivo e ai permessi espliciti, molte integrazioni dipendono da un'app installata sull'iPhone che legga e prepari le informazioni prima che un altro sistema possa usarle. Questo tutela il tuo controllo, ma può rendere meno comoda l'interoperabilità.

La stessa tensione emerge quando si vogliono combinare dati sanitari provenienti da ecosistemi diversi. Articoli recenti segnalano che la sincronizzazione tra ecosistemi sta migliorando in mercati affini, ma disponibilità e tipi di dati supportati possono variare. La domanda utile non è solo se un'app "si integra con l'app Salute". Chiediti quali tipi di dati legge, quanto storico importa, come gestisce i duplicati e quale fonte ha la priorità.

Una privacy rigorosa può ridurre la comodità. È un compromesso accettabile solo se l'app rende chiari l'esportazione, la revisione e la gestione dei permessi.

Altre lacune possono influire sull'interpretazione. L'HRV può non essere disponibile o essere incoerente su alcuni dispositivi, le fasi del sonno possono risultare frammentate e le informazioni sui sintomi richiedono spesso un'annotazione manuale e intenzionale. Questi limiti costano tempo al paziente, soprattutto quando il medico ha bisogno di contesto e non dell'ennesimo grafico senza annotazioni.

Buone pratiche per gli sviluppatori che lavorano con HealthKit

Gli sviluppatori che usano HealthKit dovrebbero trattare la consegna in background come un sistema di notifiche basato su eventi, non come un flusso continuo di frequenza cardiaca. Apple documenta che la maggior parte dei tipi di dati di watchOS ha una frequenza di consegna in background limitata, mentre alcuni tipi di eventi, tra cui frequenza cardiaca alta, frequenza cardiaca bassa e ritmo irregolare, possono essere consegnati immediatamente. Un'architettura affidabile deve tenere conto della consegna a blocchi e delle riattivazioni intermittenti dell'app.

Interroga le modifiche, non l'intero archivio

Usa una observer query con enableBackgroundDelivery per sapere quando i dati rilevanti potrebbero essere cambiati, poi usa una anchored query per recuperare solo i campioni aggiunti dall'ultimo checkpoint. In questo modo eviti di rielaborare continuamente lo stesso storico e lo stato locale dell'app diventa più facile da gestire.

Filtra i campioni degli allenamenti e i periodi di recupero prima di calcolare gli andamenti a riposo. Altrimenti gli aumenti dovuti all'esercizio fisico possono falsare il valore di base su cui si basa il rilevamento degli episodi.

Mantieni limitati archiviazione e autorizzazioni

Raggruppa le scritture tramite HKHealthStore.save quando la scrittura è necessaria. Se il prodotto si limita ad analizzare dati esistenti, preferisci l'autorizzazione in sola lettura ed evita di richiedere permessi di scrittura che non rispondono a un'esigenza chiara dell'utente.

Conserva le informazioni elaborate sul dispositivo con un livello di persistenza locale adeguato, come SwiftData o Core Data. Prima di mostrare la richiesta di autorizzazione del sistema, spiega in linguaggio semplice ogni categoria richiesta. La motivazione dei permessi deve corrispondere a ciò che fa il codice.

Infine, fai in modo che l'informativa sulla privacy rispecchi la realtà. Se l'app dichiara che l'analisi avviene in locale, l'implementazione e il flusso dei dati devono confermarlo. Un'etichetta sulla privacy non è un paragrafo di marketing: è un contratto con l'utente.

Scegliere integrazioni di cui fidarsi

Prima di toccare Consenti, fatti quattro domande pratiche:

  • Che cosa può leggere e scrivere l'app? L'accesso in sola lettura è più limitato dell'accesso in lettura e scrittura.
  • Dove avviene l'elaborazione? L'analisi sul dispositivo limita gli spostamenti non necessari di dati sensibili.
  • La spiegazione sulla privacy corrisponde alla schermata dei permessi? La descrizione dell'app dovrebbe indicare le stesse categorie che richiede.
  • Puoi esportare i dati e revocare l'accesso? Dovresti poter creare un report utile, modificare i permessi e smettere di condividere i dati senza confusione.

Un'integrazione affidabile con l'app Salute richiede i permessi minimi, spiega il suo scopo prima del consenso e tiene separati i dati grezzi dalle interpretazioni che ne derivano. Per altri consigli su come valutare le scelte di archiviazione e i permessi, consulta questa guida alla privacy dei dati sanitari.

L'integrazione più utile non è quella che raccoglie più informazioni, ma quella che trasforma i dati autorizzati in un risultato trasparente e verificabile, preservando i dati originali e il tuo controllo.


Cardiogram legge i dati di frequenza cardiaca autorizzati dall'app Salute con accesso in sola lettura, analizza gli schemi sul dispositivo e organizza episodi, andamenti, contesto e report pronti per il medico per chi tiene sotto controllo i sintomi della POTS o della disautonomia. Visita Cardiogram per scoprire come rendere più facili da rivedere e condividere i dati che già raccogli con Apple Watch e l'app Salute.

Tutti gli articoli
Cardiogram Pro

Trasforma i dati della tua frequenza cardiaca in risposte

Rilevamento automatico degli episodi, note sui sintomi, tendenze e report PDF per il cardiologo in un'unica app privata.

Prova Cardiogram gratis3 giorni gratis, disdici quando vuoi.