Integrationen: Strava, Wahoo, WHOOP, Garmin verbinden

Geplante Workout‑Uploads: wie sie funktionieren

Schritt für Schritt (Schalter standardmäßig aus, An App senden, Gerät syncen): Geplante Workouts auf Garmin oder Wahoo hochladen.

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.