Google Calendar, Apple Calendar und Zoom verbinden

Auf der Connections-Seite unter /mentor/settings/connections verknüpfst du deinen Kalender und deine Video-Anbieter mit MoveMentors. Drei Integrationen leben hier: Google Calendar (mit Meet), Apple Calendar und Zoom.

Was jede Verbindung macht

Du kannst jede Kombination verbinden. Wenn du Google und Zoom beide verbindest, kannst du pro Klasse wählen, welcher Anbieter sie hostet.

Google Calendar und Meet

1. 1

   Gehe zu /mentor/settings/connections

   Die Connections-Seite in deinem Mentor-Dashboard.

2. 2

   Klick 'Connect Google'

   Du wirst zur OAuth-Zustimmungsseite von Google weitergeleitet.

3. 3

   Wähle dein Google-Konto und erteile die Berechtigung

   Wir fragen zwei Scopes ab: Kalenderereignisse lesen (für Belegt-Zeiten) und Ereignisse erstellen (für Buchungen und Meet-Links). Mehr nicht.

4. 4

   Wähle einen Kalender (falls du mehrere hast)

   Standardmäßig nutzen wir deinen Hauptkalender. Wenn du lieber einen eigenen "MoveMentors"-Kalender willst, erstelle ihn zuerst in Google Calendar und wechsle ihn dann auf der Connections-Seite.

Sobald verbunden, generiert jede Klasse, die du als online markierst, beim Buchen automatisch einen Google-Meet-Link. Der Link landet in der Bestätigungs-E-Mail, auf der Bestätigungsseite der Buchung und im Google-Calendar-Eintrag der Session.

Apple Calendar

Apple bietet kein OAuth für Drittanbieter-Kalenderzugriff. Stattdessen erzeugst du ein "app-spezifisches Passwort" in deinem Apple-ID-Konto und fügst es in MoveMentors ein. Zwei-Faktor-Authentifizierung auf deiner Apple ID muss aktiviert sein, bevor du app-spezifische Passwörter erstellen kannst.

1. 1

   Melde dich auf appleid.apple.com an

   Verwende dieselbe Apple ID wie für iCloud Calendar.

2. 2

   Öffne 'Anmelden und Sicherheit'

   In der Seitenleiste.

3. 3

   Klick auf 'App-spezifische Passwörter'

   Wenn du diese Option nicht siehst, ist Zwei-Faktor-Authentifizierung nicht aktiv. Aktiviere sie zuerst (Einstellungen → 'Kontosicherheit' → 'Zwei-Faktor-Authentifizierung') und komm zurück.

4. 4

   Klick 'App-spezifisches Passwort erstellen'

   Oder den '+'-Button.

5. 5

   Beschrifte es mit 'MoveMentors' und klick Erstellen

   Apple fragt eventuell dein Apple-ID-Passwort zur Bestätigung erneut ab.

6. 6

   Kopiere das Passwort, das Apple anzeigt

   Es hat die Form xxxx-xxxx-xxxx-xxxx. Du siehst es nur einmal, und Apple lässt dich es nicht erneut anzeigen. Wenn du es verlierst, erstelle ein neues und widerrufe das alte.

7. 7

   Zurück in MoveMentors auf /mentor/settings/connections

   Klick 'Connect Apple'. Gib deine Apple-ID-E-Mail und das gerade kopierte app-spezifische Passwort ein. Klick Connect.

Wenn die Verbindung fehlschlägt, sind die häufigsten Ursachen:

• Falsches Passwortformat: muss das app-spezifische Passwort im Format xxxx-xxxx-xxxx-xxxx sein, nicht dein echtes Apple-ID-Passwort.
• Zwei-Faktor nicht aktiv: siehe Schritt 3.
• Passwort abgelaufen oder widerrufen: Apple invalidiert app-spezifische Passwörter, wenn du dein Apple-ID-Passwort änderst oder sie manuell widerrufst. Erzeuge ein neues.

Zoom

Die Zoom-Integration von MoveMentors erstellt bei jeder bestätigten Buchung einer als Zoom konfigurierten Klasse ein Zoom-Meeting in deinem Konto. Hinzufügen, Nutzen und Entfernen der App werden alle von MoveMentors aus gestartet.

Zoom hinzufügen (Connect)

1. 1

   Du brauchst ein Zoom-Konto

   Ein kostenloses Zoom-Konto reicht (40-Minuten-Limit für Gruppenmeetings). Ein bezahlter Pro-Plan hebt das Limit auf. Registriere dich auf zoom.us, falls du noch kein Konto hast.

2. 2

   Gehe zu /mentor/settings/connections und klick 'Connect Zoom'

   Du wirst zur OAuth-Zustimmungsseite von Zoom weitergeleitet.

3. 3

   Erteile die angefragten Berechtigungen

   Drei Scopes: Meetings auf deinem Konto erstellen (meeting:write:meeting), Meeting-Details lesen (meeting:read:meeting) und dein Basisprofil lesen (user:read:user), damit die Host-Info stimmt. Mehr nicht.

4. 4

   Fertig

   Du kommst zurück zu MoveMentors mit der Zoom-Zeile, die 'Connected as <dein Name>' anzeigt.

Zoom nutzen (pro Klasse)

Für jede Online-Klasse, die du erstellst, kannst du Google Meet oder Zoom als Video-Anbieter wählen. Wenn nur einer von beiden verbunden ist, wird er automatisch genutzt, ohne Auswahl.

Wenn ein Schüler eine Zoom-Klasse bucht, macht MoveMentors:

1. Erstellt ein geplantes Meeting auf deinem Zoom-Konto (Typ 2: geplant, join-before-host aktiv, kein Warteraum).
2. Speichert die Meeting-URL auf der Buchung.
3. Sendet den Link in der Bestätigungs-E-Mail.
4. Zeigt die URL auf der Bestätigungsseite des Schülers und auf deiner Session-Verwaltungsseite an.

Jede Session einer wiederkehrenden Klasse bekommt ihr eigenes geplantes Meeting.

Zoom entfernen (Disconnect)

1. 1

   Gehe zu /mentor/settings/connections

   Die Connections-Seite.

2. 2

   Klick 'Disconnect' in der Zoom-Zeile

   Wir löschen die verschlüsselten Zoom-Tokens aus unserer Datenbank sofort und erstellen keine neuen Meetings mehr.

3. 3

   Optional: auch in Zoom widerrufen

   Auf marketplace.zoom.us anmelden → 'Manage' → 'Added Apps' → MoveMentors widerrufen. Das entfernt unsere App aus deiner installierten App-Liste auf Zoom-Seite.

Vergangene Meetings, die bereits in deinem Zoom-Konto erstellt wurden, bleiben dort; wir löschen sie nicht rückwirkend. Wenn du sie aufräumen möchtest, mach das in deinem Zoom-Konto.

Welche Anmeldedaten wir speichern

• Google: ein OAuth-Refresh-Token und ein Access-Token. Verschlüsselt im Ruhezustand mit AES-256-GCM. Wir erneuern Access-Tokens automatisch, ohne dich erneut zu fragen.
• Apple: deine Apple-ID-E-Mail und das app-spezifische Passwort. Verschlüsselt im Ruhezustand mit AES-256-GCM. Genutzt für CalDAV-Requests an caldav.icloud.com.
• Zoom: ein OAuth-Refresh-Token und ein Access-Token. Verschlüsselt im Ruhezustand mit AES-256-GCM. Zoom rotiert Refresh-Tokens bei jedem Refresh; wir persistieren bei jeder Rotation neu.

Nichts wird im Klartext geloggt, über unsichere Verbindungen gesendet oder mit anderen geteilt. Du kannst den Zugriff jederzeit in den Einstellungen des jeweiligen Anbieters widerrufen:

• Google: myaccount.google.com → Sicherheit → Drittanbieter-Apps
• Apple: appleid.apple.com → App-spezifische Passwörter → MoveMentors widerrufen
• Zoom: marketplace.zoom.us → Manage → Added Apps → MoveMentors widerrufen

Was wann synchronisiert wird

• Neue Buchung bestätigt → Meet- oder Zoom-Link erzeugt, Kalenderereignis angelegt (für Online-Klassen bei Google), Bestätigungs-E-Mail geht raus
• Buchung storniert → Kalenderereignis entfernt (nur Google; Apple ist von unserer Seite nur lesend)
• Klassentermin verschoben → das Ereignis in deinem Kalender wandert mit (nur Google)
• Du trennst die Verbindung → bestehende Ereignisse bleiben im Kalender; wir pushen keine neuen mehr; verschlüsselte Zugangsdaten werden gelöscht

Updates laufen nahezu in Echtzeit über Hintergrund-Jobs.

Häufige Fragen

Kann ich mit Outlook synchronisieren? Nativ noch nicht. Workaround: Abonniere den .ics-Feed deines Stundenplans auf der Connections-Seite (siehe "For other calendar apps" unten). Das funktioniert in Outlook, Fastmail, ProtonCalendar oder jeder App, die webcal-Abos unterstützt.

Meine Kalenderereignisse erscheinen in der falschen Zeitzone. Wahrscheinlich unterscheidet sich die Zeitzone deines Kalenderkontos von der der Klasse. Das Ereignis wird in der Zeitzone der Klasse gespeichert (richtig); dein Kalender zeigt es konvertiert in deine Kontozeitzone (richtig). Es wirkt nur "schief", wenn du gereist bist. Passe die Zeitzone deiner Kalender-App an, wenn du dauerhaft umgezogen bist.

Sync funktioniert nicht mehr / Ereignisse veraltet. Häufigster Grund: Token abgelaufen oder widerrufen. Geh auf /mentor/settings/connections; die Zeile des betroffenen Anbieters zeigt "Not connected". Neu verbinden.

Können auch meine Präsenzbuchungen im Kalender erscheinen? Aktuell schreibt Google nur Online-Klassen-Buchungen in deinen Kalender (damit der Meet-Link am Ereignis hängt). Für Präsenzklassen abonniere den .ics-Feed deines Stundenplans (Connections-Seite → unten); der enthält alles, was du unterrichtest.

40-Minuten-Zoom-Limit nervt? Der kostenlose Zoom-Tarif begrenzt Gruppenmeetings auf 40 Minuten. Optionen: Upgrade auf Zoom Pro (ca. 15 $/Monat), um das Limit aufzuheben, oder die Klasse auf Google Meet umstellen (kein Zeitlimit im kostenlosen Google-Tarif).

Nächste Schritte

• Stundenplan und Wiederholungen: Klassenzeiten festlegen.
• Kalender-Synchronisation für Schüler: das Schüler-Pendant.