## Übersicht

N+One integriert Strava, Wahoo, WHOOP und Garmin, um Fahrdateien, Gesundheitsmetriken und Geräte‑Workout‑Uploads in deinen adaptiven Trainingsplan zu bringen. Verwende die Seite Device Integrations, um zu verbinden, zu trennen und den Sync‑Status zu prüfen.

Dieser Artikel erklärt, welche Daten jede Integration teilt, wie geplante Workout‑Uploads für unterstützte Geräte funktionieren, wie N+One Duplikate und Pendel‑Fahrten handhabt sowie grundlegende OAuth‑ und Fehlerbehebungs‑Schritte.

Wichtig: Verbinde die Quellen, die du bereits nutzt (Power‑Dateien, HF, Schlaf) und aktiviere Workout‑Upload für Wahoo oder Garmin, wenn du geplante Einheiten auf deinem Gerät haben möchtest.

## Wo du Integrationen verwaltest

Öffne das Profilmenü in der App‑Kopfzeile und gehe zu Settings → Device Integrations, oder rufe direkt /settings/integrations auf. Der Seitentitel lautet "Device Integrations" und zeigt aktive Verbindungen mit Status, letztem Sync sowie Aktionen zum Verbinden / Trennen.

Wenn du das Onboarding nicht abgeschlossen hast, wirst du vor dem Verbinden von Integrationen nach /onboarding umgeleitet.

## Welche Daten jede Integration synchronisiert

- Strava
  - Verbinde Strava, um Aktivitätsdateien (Fahrten) in N+One zu synchronisieren. Aktivitäten aus Strava erscheinen in deinem Trainingskalender und fließen in Readiness‑ und Performance‑Analysen ein.
  - Pendel‑Fahrten können durch die Profil‑Einstellung "exclude commute activities" ausgeschlossen werden (diese Einstellung ist in deinem Profil verfügbar und standardmäßig aktiviert). Wenn du möchtest, dass Pendler‑Fahrten zählen, schalte diese Option in /settings/profile um.
  - Wenn N+One eine abgeschlossene Strava‑Aktivität einem geplanten Training zuordnet, dedupliziert die UI die Einträge, sodass du primär die abgeschlossene Fahrt mit geplantem Kontext auf der Trainingsseite (/training) siehst.

- Wahoo
  - Wahoo verbindet sich via OAuth, um Aktivitäten zu synchronisieren. Wenn aktiviert, kann N+One geplante Workouts an kompatible Wahoo‑Geräte (ELEMNT, KICKR) oder an das Wahoo‑Ökosystem hochladen.
  - Upload ist eine Option, die du auf der Device Integrations Seite aktivierst — wenn du sie einschaltest, werden geplante Workouts gepusht, sodass du sie auf deinem Wahoo‑Gerät ausführen kannst.

- WHOOP
  - WHOOP synchronisiert Strain, Recovery und Schlafdaten mit N+One. Diese Daten speisen die Readiness‑Berechnungen und helfen dem AI Coach, die richtige nächste Einheit zu empfehlen.

- Garmin
  - Garmin synchronisiert Aktivitäten und Gesundheitsmetriken wie Schlaf, HRV und Ruheherzfrequenz. Diese Metriken werden von den Readiness‑ und Performance‑Modellen von N+One verwendet.
  - Du kannst geplanten Workout‑Upload zu Garmin Connect / kompatiblen Garmin‑Geräten auf der Device Integrations Seite aktivieren. Wenn aktiviert, werden geplante Workouts hochgeladen, sodass du sie auf dem Gerät fahren kannst.

- Oura Ring (kommt bald)
  - Oura wird auf der Integrationsseite mit einem Hinweis angezeigt, dass die vollständige Integration bald kommt. Die Karte ist heute inaktiv und kann nicht verbunden werden.

- Zwift‑Workout‑Upload (kommt bald)
  - Die Integrationsseite enthält eine Zwift‑Karte, die strukturiertes Indoor‑Training beschreibt, aber der Text weist darauf hin, dass eine vollständige Integration bald kommt. Heute gibt es kein aktives OAuth oder Upload zu Zwift.

## Geplante Workout‑Uploads: wie sie funktionieren

Wenn du den Workout‑Upload für Wahoo oder Garmin unter /settings/integrations aktivierst:

- N+One lädt geplante Einheiten hoch, sodass das Workout auf deinem Gerät oder im Speicher von Garmin Connect / Wahoo erscheint.
- Uploads sind session‑basierte geplante Workouts (Intervallstruktur), die aus dem Plan generiert werden. Das Gerät führt das Workout aus, während du fährst.
- Wenn eine geplante Einheit später mit einer abgeschlossenen Aktivität abgeglichen wird, dedupliziert N+One die Kalenderansicht, sodass du die abgeschlossene Aktivität mit geplantem Kontext siehst.

Hinweis: Zwift‑Workout‑Upload ist eine geplante Funktion (kommt bald). Erwarte heute keine Zwift‑Uploads in der App.

## OAuth: verbinden, zurückkehren und mögliche Meldungen

Verbindungen verwenden OAuth. Nachdem du einem Anbieter die Autorisierung erteilt hast, wirst du zu N+One zurückgeleitet und die Rückgabe‑URL kann Statusmeldungen enthalten.

Gängige Query‑Meldungen, die du bei der Rückkehr sehen könntest:

- success — Autorisierung abgeschlossen und die Integration ist verbunden.
- oauth_failed — der OAuth‑Flow ist fehlgeschlagen. Versuche, die Verbindung erneut herzustellen (Schritte weiter unten).
- whoop_profile_failed — WHOOP‑Profilabfrage ist nach der Auth fehlgeschlagen. Versuche, dich erneut zu verbinden; wenn das Problem weiterhin besteht, kontaktiere den Support.
- unauthorized — die Autorisierung wurde abgelehnt oder ist abgelaufen.

Wenn du nach der Rückkehr von einem Anbieter eine Fehlermeldung in der URL siehst, gehe zu /settings/integrations und versuche, die Verbindung für diesen Anbieter erneut herzustellen.

## Verbindungen verwalten

- Zum Verbinden: öffne Settings → Device Integrations (/settings/integrations), wähle den Anbieter und folge den OAuth‑Anweisungen.
- Zum erneuten Verbinden: nutze denselben Ablauf von /settings/integrations. Wenn ein Anbieter einen OAuth‑Fehler meldet, versuche zu trennen und erneut zu verbinden.
- Zum Trennen: öffne /settings/integrations und nutze die Trennen‑Aktion für den jeweiligen Anbieter. Das Trennen entfernt die aktive Verknüpfung zwischen Konten; bereits synchronisierte Aktivitäten bleiben in deinem Konto, sofern sie nicht explizit gelöscht werden.
- Prüfe die Integrationskarte auf "last sync" und den Sync‑Status nach dem Verbinden. Es kann ein paar Minuten dauern, bis neuere Aktivitäten erscheinen.

## Duplikate, Matching und Pendel‑Fahrten

- Trainingseinheiten stammen aus synchronisierten Integrationen und geplanten Workouts. N+One versucht, geplante Einheiten mit abgeschlossenen Fahrten abzugleichen; bei Match dedupliziert die UI die Einträge im Trainingskalender (/training).
- Wenn du scheinbare Duplikate siehst, öffne die Sitzungsdetails (/training/[id]), um zu prüfen, ob ein Eintrag eine geplante Einheit und der andere eine abgeschlossene Aktivität ist.
- Pendelaktivitäten: Stravas Pendler‑Flag (oder Aktivitäts‑Metadaten) kann ausgeschlossen werden, wenn deine Profil‑Einstellung "exclude commute activities" aktiviert ist. Diese Einstellung ist in Code‑Pfaden standardmäßig eingeschaltet; du kannst sie in /settings/profile ändern.

## Sync‑Häufigkeit und Offline‑Verhalten

- Integrationen nutzen Hintergrund‑Sync über die API des Anbieters. Die Device Integrations Seite zeigt die Zeit des letzten Syncs.
- Neue Syncs und der AI Coach erfordern Netzwerkzugang. Wenn du offline bist, funktionieren zuvor aufgerufene Seiten möglicherweise aus dem Cache; besuche /offline für Details, welche Seiten nicht gecached oder eingeschränkt sind.
- Die App läuft als PWA und kann dich zur Installation auffordern; siehe /install-pwa für die Installationsanleitung.

## Fehlerbehebungs‑Checkliste

Wenn eine Integration sich nicht wie erwartet verhält, versuche diese Schritte in der Reihenfolge:

1. Bestätige deine Verbindung auf /settings/integrations und prüfe die Karte auf Fehler oder die Zeit für "last sync".
2. Verbinde den Dienst erneut über /settings/integrations. Schließe den OAuth‑Flow ab und achte auf eine Erfolgsmeldung bei der Rückkehr.
3. Wenn ein OAuth‑Fehler erscheint (oauth_failed, unauthorized, whoop_profile_failed), versuche zu trennen und erneut zu verbinden. Überprüfe, dass du die angeforderten Berechtigungen auf Seiten des Anbieters erlaubt hast.
4. Stelle sicher, dass dein Browser Popups und Third‑Party‑Cookies für den OAuth‑Flow erlaubt. Private/Inkognito‑Fenster blockieren den Flow manchmal.
5. Prüfe dein Netzwerk. Einige Funktionen (AI Coach, neue Syncs) benötigen eine Live‑Verbindung.
6. Überprüfe die Profil‑Einstellung "exclude commute activities" in /settings/profile, falls Fahrten fehlen.
7. Wenn geplante Workouts nach Aktivierung des Uploads nicht auf deinem Gerät erscheinen, bestätige, dass du den Upload‑Schalter auf der Wahoo‑ oder Garmin‑Integrationskarte aktiviert hast und warte ein paar Minuten, bis der Push abgeschlossen ist.
8. Wenn Daten immer noch nicht erscheinen, öffne /settings/support, um das Problem zu melden. Gib den Namen des Anbieters, die angezeigte Fehlermeldung und den ungefähren Zeitstempel deines letzten Sync‑Versuchs an.

## Datenschutz und Datenhinweise

Integrationen teilen Daten mit N+One entsprechend den Berechtigungen, die du während OAuth gewährst. Siehe /settings/privacy oder unsere öffentliche /privacy‑Seite für Details dazu, wie wir Integrationsdaten speichern und verwenden.

## Wann du den Support kontaktieren solltest

Nutze /settings/support, wenn:

- Eine Integration nach wiederholten Versuchen nicht verbunden werden kann.
- Du nach erneuten Verbindungsversuchen unerklärliche OAuth‑Fehlercodes siehst.
- Geplanter Workout‑Upload dein Wahoo‑ oder Garmin‑Gerät nach Aktivierung des Schalters nicht erreicht.

Gib nach Möglichkeit Zeitstempel und Screenshots an; das beschleunigt die Diagnose.

## Schneller Erst‑Verbindungs‑Ablauf

1. Öffne das Profilmenü → Settings → Device Integrations (/settings/integrations).
2. Wähle Strava, Wahoo, WHOOP oder Garmin und folge den OAuth‑Anweisungen.
3. Nach der Rückkehr bestätige, dass die Integrationskarte eine aktuelle "last sync"‑Zeit und keine Fehlermeldungen anzeigt.
4. Wenn du geplante Einheiten auf dem Gerät haben möchtest, aktiviere den Workout‑Upload auf der Wahoo‑ oder Garmin‑Integrationskarte.
5. Prüfe Training (/training), um synchronisierte Aktivitäten und deren Abgleich mit geplanten Einheiten zu sehen.

## Weiterführende Lektüre

- Wenn du FTP‑basierte Pläne nutzt, siehe den FTP‑Artikel für Kontext: /knowledge-base/ftp-is-a-snapshot-durability-is-the-real-story
- Um zu lernen, wie N+One Fahrten automatisch analysiert, siehe: /knowledge-base/automatic-workout-analysis-ai-insights
- Für Tipps zum Indoor‑Training und Zwift‑Kontext (Zwift‑Upload kommt bald): /knowledge-base/winter-cycling-training-zwift-gear

Wenn du nicht weiterkommst, öffne /settings/support — wir helfen dir, die Quellen zu verbinden, die deinen Plan ehrlich und adaptiv halten.