Integraties met wearables

Cliënten kunnen hun Garmin Connect, Polar, Apple Health (iPhone) of Samsung Health (Android) koppelen vanuit de Coachio-app. De koppeling doet de cliënt zelf, jij hoeft als coach niets in te stellen en kunt het ook niet voor hem doen.

De integraties gaan twee kanten op:

• Uitlezen (import): gezondheidsgegevens komen binnen als meetgegevens en gewoonten, en voltooide trainingen van een Garmin- of Polar-horloge komen binnen als sessie bij de cliënt.
• Exporteren: trainingen die jij inplant worden naar het Garmin-horloge van de cliënt gestuurd.

Trainingen die je cliënt op zijn horloge doet

Neemt je cliënt een training op met zijn Garmin- of Polar-horloge, dan komt die sessie in Coachio binnen zodra het horloge heeft gesynchroniseerd. Bij Apple Health en Samsung Health gebeurt dat niet: daar komen alleen dag- en gezondheidsgegevens uit.

Wat er met zo'n sessie gebeurt:

• Staat er die dag een training van dezelfde sport voor de cliënt klaar, dan wordt die afgevinkt en krijgt hij de werkelijke cijfers erbij.
• Is er geen kandidaat, of zijn er meerdere die evenveel kans maken, dan komt de sessie er los bij te staan. Bij twijfel vinkt Coachio niets af.
• Rustdagen, overgeslagen trainingen en trainingen van een andere dag doen niet mee.

In de trainingkaart zie je een blok Werkelijk met wat het horloge heeft gemeten: tijd, gemiddelde en maximale hartslag en calorieën, en bij een sport die afstand aflegt ook afstand, tempo of snelheid en hoogtemeters. Bij een Garmin-sessie staat het Garmin-woordmerk erbij, zodat duidelijk is waar de cijfers vandaan komen.

Past de cliënt zijn activiteit achteraf aan in Garmin Connect of Polar Flow, dan volgen de cijfers in Coachio. Verandert hij daar de sport, dan wordt alleen een sessie aangepast die door de import zelf is aangemaakt. Wat jij hebt ingepland blijft ongewijzigd.

Wat niet meekomt van een voltooide training

Sets, herhalingen en gewichten van een krachtsessie komen niet mee, en ook cadans, GPS-routes, rondetijden en hartslagzones niet. Wat een krachttraining precies inhield blijft dus wat de cliënt in de Coachio-app logt.

Bij Polar komt alleen binnen wat de cliënt na het koppelen opneemt. Wat daarvoor op zijn horloge stond, komt niet alsnog mee.

Wat wordt uitgelezen, en wat niet

Garmin

Garmin levert veruit de meeste gegevens.

Wel	Stappen, slaapduur, slaapscore, actieve duur, actieve calorieën, dagelijkse activiteit (%), rusthartslag, bloeddruk (systolisch, diastolisch, pols), gewicht, spiermassa, botmassa, lichaamsvocht (%), vetpercentage, BMI, HRV (nachtgemiddelde en piek), stressniveau, body battery, ademhalingsfrequentie, VO2max en fitnessleeftijd. Daarnaast voltooide trainingen, zie hierboven.
Niet	Sets, herhalingen en gewichten, cadans, GPS-routes, rondetijden en hartslagzones per training.

Dagelijkse activiteit (%) krijgt Coachio niet van Garmin: die wordt berekend uit de stappen van die dag en het stappendoel van de cliënt.

Polar

Polar levert een stuk minder dan Garmin. Dat is een beperking van Polar zelf, niet van Coachio.

Wel	Slaapduur, slaapscore, actieve duur, dagelijkse activiteit (%), calorieën, stappen, cardio load, cardio load ratio, gemiddelde nachtelijke HRV en gemiddelde ademhalingsfrequentie tijdens de nacht. Daarnaast voltooide trainingen, zie hierboven.
Niet	Sets, herhalingen, cadans of hartslagzones per training. Verder geen bloeddruk, lichaamssamenstelling, VO2max, body battery of rusthartslag.

De nachtelijke HRV en ademhalingsfrequentie komen uit Polar Nightly Recharge. Polar levert die gegevens niet via een apart bericht; Coachio haalt ze op wanneer de slaapgegevens van die nacht binnenkomen. Nightly Recharge zelf heeft een schaal van 1 tot 6 en wordt niet als body battery opgeslagen, omdat die schaal niet vergelijkbaar is met een percentage.

Apple Health & Samsung Health

De Coachio-app leest deze gegevens rechtstreeks van de telefoon van de cliënt.

Wel	Stappen, afstand, calorieën, hartslag en gewicht.
Niet	Alles daarbuiten: geen trainingen, geen slaap, geen HRV, geen lichaamssamenstelling en geen bloeddruk.

En Fitbit, Whoop of Oura?

Daar is op dit moment geen koppeling voor. Samsung Health kan wel: die loopt via Health Connect, zie Hoe koppelt een cliënt.

Welke bron wint bij dubbele gegevens?

Heeft een cliënt meerdere bronnen gekoppeld, dan bepaalt Coachio per dag welke waarde blijft staan:

• Bij stappen, afstand en calorieën wint de hoogste waarde van die dag.
• Bij de rest wint de wearable (Garmin of Polar) van de telefoon (Apple Health of Samsung Health). Staan Garmin en Polar allebei aan, dan wint de laatste synchronisatie.
• Een waarde van nul wordt nooit weggeschreven.
• Een waarde die de cliënt zelf invulde op een dag waarop nog geen tracker iets had gestuurd, blijft staan.

Een handmatige correctie op een gesynchroniseerde waarde kan verdwijnen

Past de cliënt een waarde aan die eerder van zijn horloge kwam, dan kan een volgende synchronisatie daar overheen gaan. Klopt een meting structureel niet, laat hem het veld dan in de app op Negeren zetten en de waarde als eigen meting bijhouden.

Waar de gegevens terechtkomen

Na het koppelen van Garmin of Polar kiest de cliënt in zijn app per veld wat ermee moet gebeuren: een nieuwe meting of gewoonte aanmaken, koppelen aan een bestaande die jij hebt toegewezen, of negeren. Dat scherm zit in de app, niet in jouw dashboard: je kunt de koppeling dus niet voor hem instellen.

Wil je dat een waarde van zijn horloge in een specifieke meting of gewoonte landt, wijs die dan eerst aan de cliënt toe (zie Meetgegevens en Gewoonten) en vraag hem die in de app aan het juiste veld te koppelen. Bij Apple Health en Samsung Health ligt de koppeling vast en valt er niets te kiezen.

Trainingen naar Garmin sturen

Plan je een training in voor een cliënt met een gekoppelde Garmin, dan zet Coachio die training automatisch op de juiste dag klaar op zijn horloge. Pas je de training aan, dan wordt de Garmin-versie bijgewerkt.

Wat er meegestuurd wordt:

• De naam van de training (programma + training) en je instructies.
• Het soort training: kracht, cardio of HIIT.
• Alle stappen, met hun duur of afstand. Bij cardio ook de intensiteit: warming-up, actief, rust en cooling-down.
• Bij krachttraining: herhalingen, gewicht en de rustpauzes, inclusief het aantal sets of rondes.
• Bij bekende kracht- en HIIT-oefeningen: de officiële Garmin-oefeningnaam en categorie. Daardoor toont het horloge bijvoorbeeld Barbell Bench Press in plaats van alleen een algemene stap. Is een oefening niet gekoppeld aan Garmins lijst, dan gebruikt Coachio de eigen oefeningstitel als omschrijving.
• Waar mogelijk het hartslag-, vermogens- of tempodoel van een cardiostap. Percentagedoelen worden voor de cliënt omgerekend met diens trainingsprofiel.

Wat er niet meegaat:

• Een percentagedoel waarvoor de benodigde waarde in het Trainingsprofiel ontbreekt. Zonder bijvoorbeeld maximale hartslag, LTHR, FTP of drempeltempo verzint Coachio geen Garmin-doel; de stap en duur worden wel verstuurd.
• Een doel op gevoel (RPE): Garmin kent daar geen doeltype voor. Hetzelfde geldt voor een percentage dat buiten het bereik valt dat Garmin accepteert.
• Rustdagen en lege trainingen.
• Bij een cardiotraining: losse oefeningen die naast de cardioblokken staan. Andersom gaan bij een krachttraining de cardioblokken niet mee. Een gecombineerde dag wordt bij het toewijzen al per sport gesplitst, dus die komt als losse sessies op het horloge.
• Alles boven de 250 stappen in één training.

Toestemming voor trainingen

Bij het koppelen moet de cliënt bij Garmin ook expliciet toestemming geven voor trainingen. Slaat hij dat vinkje over, dan weigert Garmin de trainingen en komt er niets op het horloge terecht. De cliënt krijgt dan vanzelf een melding om Garmin opnieuw te koppelen; zodra hij dat doet, worden de trainingen alsnog verstuurd.

Er komt niets op het horloge: opnieuw verbinden

Verreweg de meest voorkomende oorzaak is de toestemming voor trainingen bij Garmin. Die geeft de cliënt bij het koppelen, en hij is los uit te zetten. Ontbreekt hij, dan weigert Garmin elke training die wij sturen, en blijft dat weigeren tot de koppeling opnieuw is gelegd.

Coachio ziet dat en stuurt de cliënt zelf een melding om Garmin opnieuw te verbinden, met een link naar het koppelscherm in de app. Die melding komt hoogstens één keer per maand, zodat een koppeling die al weken scheef staat niet elke dag om aandacht vraagt. Zie je een cliënt met een lege trainingsagenda op zijn horloge, wacht dan niet op die melding maar vraag hem dit te doen:

1. Open de app, ga naar Mijn omgeving > Koppelingen.
2. Tik op de Garmin-kaart en kies Verbinding verwijderen.
3. Koppel opnieuw, en laat op het toestemmingsscherm van Garmin alle vinkjes aan staan.

Zodra de koppeling er weer staat, worden de trainingen alsnog verstuurd. Wat de cliënt al heeft gelogd blijft gewoon staan.

Andere oorzaken, in volgorde van waarschijnlijkheid

Blijft het na opnieuw verbinden leeg, loop dan dit af: staat de training op een datum (een schema zonder trainingsdagen komt nergens terecht), is het geen rustdag of lege training, en gaat het om een training die bij het soort past (cardioblokken in een cardiotraining, oefeningen in een krachttraining)?

Polar en Apple Health

Naar Polar kunnen geen trainingen worden gestuurd: de Polar-koppeling is alleen-lezen, daar valt van onze kant niets aan te doen. Naar Apple Health en Samsung Health sturen we ook geen trainingen.

Hoe koppelt een cliënt?

De koppeling doet de cliënt zelf in de app, via Mijn omgeving > Koppelingen. Hij ziet daar kaarten voor Garmin Connect, Polar, en afhankelijk van zijn telefoon Apple Health (iPhone) of Samsung Health (Android). In hetzelfde scherm staat ook de koppeling met Google Calendar. Een gekoppelde kaart wordt groen en krijgt de badge Verbonden.

Kun je hem daarbij helpen? Deze dingen gaan in de praktijk mis:

Garmin Connect en Polar

De cliënt tikt op de kaart en wordt doorgestuurd naar de inlogpagina van Garmin of Polar. Daar logt hij in en geeft hij toestemming. Meer hoeft hij niet te doen: in Garmin Connect of Polar Flow zelf hoeft hij niets in te stellen.

Bij Garmin moet hij op dat toestemmingsscherm wel alle vinkjes aanlaten. Zet hij de toestemming voor trainingen uit, dan komen jouw trainingen niet op zijn horloge. Hij krijgt dan vanzelf een melding om opnieuw te koppelen, en zodra hij dat doet worden de trainingen alsnog verstuurd.

Apple Health (iPhone)

De cliënt krijgt het permissiescherm van iOS te zien en geeft daar toegang tot zijn gegevens. Coachio schrijft niets terug naar Apple Health, alleen lezen is genoeg.

Let op bij Apple Health

Weigert de cliënt de toegang, dan gebeurt er verder niets: er komt geen foutmelding en de kaart blijft op Koppel staan. Zegt een cliënt dat het "niet werkt", laat hem dan onder Instellingen > Privacy en beveiliging > Gezondheid > Coachio controleren welke onderdelen aan staan.

Samsung Health (Android)

Coachio leest niet rechtstreeks uit Samsung Health, maar uit Health Connect, de gezondheidskluis van Android. De cliënt geeft Coachio in het Health Connect-scherm toegang tot de gegevens die hij wil delen.

Samsung Health moet zelf ook naar Health Connect schrijven

Dit is de meest voorkomende oorzaak van een lege koppeling. De kaart in Coachio kan Verbonden zeggen terwijl er niets binnenkomt, simpelweg omdat Samsung Health zijn gegevens niet in Health Connect zet. De cliënt moet dat apart aanzetten in Samsung Health > Instellingen > Health Connect. De app geeft dit niet aan.

Staat Health Connect niet op zijn toestel, dan verschijnt de Samsung Health-kaart helemaal niet.

Synchronisatie schema

• Garmin en Polar sturen hun gegevens vanzelf naar Coachio, ook als de cliënt de app niet opent. Een voltooide training komt binnen zodra het horloge met Garmin Connect of Polar Flow heeft gesynchroniseerd.
• Apple Health en Samsung Health synchroniseren wanneer de cliënt de app naar de voorgrond haalt. Er is geen knop om handmatig te synchroniseren. Ziet een cliënt zijn stappen van gisteren niet terug: de app naar de voorgrond halen is genoeg.

Ontkoppelen / toegang intrekken

Bij Garmin en Polar kan de cliënt in de app op de verbonden kaart tikken en onderaan kiezen voor Verbinding verwijderen.

Bij Apple Health en Samsung Health kan dat niet vanuit Coachio: hij trekt de toegang in via de instellingen van zijn telefoon (bij iOS onder Gezondheid, bij Android in Health Connect). De app legt dat ter plekke uit.

Loskoppelen stopt toekomstige synchronisatie. Algemene gezondheidsmetingen en al binnengekomen trainingen die al in de Coachio-geschiedenis staan, kunnen blijven staan totdat de cliënt ze laat verwijderen of het account verwijdert. Bij het verbreken van de Garmin-koppeling worden via Garmin ontvangen cyclus- en zwangerschapsgegevens wel verwijderd. Wat de cliënt zelf heeft ingevoerd blijft staan.

Meer over de afzonderlijke deeltoestemmingen en externe verwerking staat bij Cyclus en zwangerschap.

Status checken als coach

Je kunt in het dashboard niet zien of een cliënt gekoppeld is. Wat je wel ziet: of zijn meetgegevens en gewoonten vanzelf vollopen, en of er sessies van zijn horloge binnenkomen. Blijft dat leeg, dan is er iets mis met de koppeling en is bovenstaande lijst je checklist.