De Connections-pagina op /mentor/settings/connections is waar je je agenda en videoaanbieders koppelt aan MoveMentors. Drie integraties leven hier nu: Google Agenda (met Meet), Apple Agenda en Zoom.
Wat elke koppeling doet
| Aanbieder | Wat hij leest | Wat hij schrijft |
|---|---|---|
| Google Agenda en Meet | Je bezette tijden uit de agenda die je kiest | Boekingen van online klassen verschijnen in je agenda met een Google Meet-link |
| Apple Agenda | Je bezette tijden uit iCloud | Niets terug naar iCloud (Apple's API laat dat niet toe zoals Google dat doet) |
| Zoom | Niets | Wanneer een boeking bevestigd wordt op een klas die op Zoom staat, maken we een meeting aan op jouw Zoom-account |
Je kunt elke combinatie koppelen. Als je zowel Google als Zoom koppelt, kun je per klas kiezen welke videoaanbieder hem host.
Google Agenda en Meet
Ga naar /mentor/settings/connections
De Connections-pagina in je mentordashboard.
Klik 'Connect Google'
Je wordt doorgestuurd naar Google's OAuth-toestemmingsscherm.
Kies je Google-account en geef toestemming
We vragen twee scopes: agenda-events lezen (voor bezette tijden) en events aanmaken (voor boekingen en Meet-links). Niets meer.
Kies een agenda (als je er meerdere hebt)
Standaard gebruiken we je primaire. Wil je liever een aparte "MoveMentors"-agenda, maak die dan eerst aan in Google Agenda en wissel er via de Connections-pagina naartoe.
Eenmaal gekoppeld genereert elke klas die je als online markeert automatisch een Google Meet-link wanneer een student boekt. De link komt in de bevestigingsmail, op de bevestigingspagina van de boeking en in het Google Agenda-event van die sessie.
Apple Agenda
Apple biedt geen OAuth voor toegang door derden tot je agenda. In plaats daarvan maak je een "app-specifiek wachtwoord" aan vanuit je Apple ID-account en plak je dat in MoveMentors. Tweestapsverificatie op je Apple ID moet aanstaan voordat je app-specifieke wachtwoorden kunt maken.
Log in op appleid.apple.com
Gebruik dezelfde Apple ID die je gebruikt voor iCloud Agenda.
Open 'Inloggen en beveiliging'
In de zijbalk.
Klik 'App-specifieke wachtwoorden'
Zie je die optie niet, dan staat tweestapsverificatie niet aan. Zet hem eerst aan (Instellingen → 'Accountbeveiliging' → 'Tweestapsverificatie') en kom terug.
Klik 'Genereer een app-specifiek wachtwoord'
Of de '+'-knop.
Label het 'MoveMentors' en klik Aanmaken
Apple kan vragen je Apple ID-wachtwoord opnieuw in te voeren ter bevestiging.
Kopieer het wachtwoord dat Apple toont
Het ziet er uit als
xxxx-xxxx-xxxx-xxxx. Je ziet het maar één keer, en Apple laat je het niet opnieuw bekijken. Raak je het kwijt, genereer een nieuw en trek het oude in.Terug in MoveMentors, ga naar /mentor/settings/connections
Klik 'Connect Apple'. Vul je Apple ID-mail in en het app-specifieke wachtwoord dat je net hebt gekopieerd. Klik Connect.
Lukt de koppeling niet, dan zijn de meest voorkomende oorzaken:
- Verkeerd wachtwoordformaat: moet het app-specifieke wachtwoord in
xxxx-xxxx-xxxx-xxxx-vorm zijn, niet je echte Apple ID-wachtwoord. - Tweestapsverificatie niet aan: zie Stap 3.
- Wachtwoord verlopen of ingetrokken: Apple maakt app-specifieke wachtwoorden ongeldig wanneer je je Apple ID-wachtwoord wijzigt of ze handmatig intrekt. Maak een nieuwe.
Zoom
De Zoom-integratie van MoveMentors maakt een Zoom-meeting aan op jouw account telkens als een boeking bevestigd wordt voor een klas waarvan Zoom de videoaanbieder is. Toevoegen, gebruiken en verwijderen van de app worden allemaal vanuit MoveMentors gestart.
Zoom toevoegen (Connect)
Je hebt een Zoom-account nodig
Een gratis Zoom-account voldoet (limiet van 40 minuten op groepsmeetings). Een betaald Pro-plan heft de limiet op. Registreer je op zoom.us als je nog geen account hebt.
Ga naar /mentor/settings/connections en klik 'Connect Zoom'
Je wordt doorgestuurd naar Zooms OAuth-toestemmingsscherm.
Geef de gevraagde toestemmingen
Drie scopes: meetings aanmaken op je account (
meeting:write:meeting), meeting-details lezen (meeting:read:meeting) en je basisprofiel lezen (user:read:user) zodat de host-info klopt. Niets meer.Klaar
Je keert terug naar MoveMentors met de Zoom-rij die 'Connected as <jouw naam>' toont.
Zoom gebruiken (per klas)
Voor elke online klas die je aanmaakt kun je Google Meet of Zoom als videoaanbieder kiezen. Als je er slechts één gekoppeld hebt, wordt die automatisch gebruikt, zonder keuzemenu.
Wanneer een student een Zoom-klas boekt, doet MoveMentors:
- Maakt een geplande meeting aan op je Zoom-account (type 2: gepland, join-before-host aan, geen wachtruimte).
- Slaat de meeting-URL op bij de boeking.
- Stuurt de link mee in de bevestigingsmail.
- Toont de URL op de bevestigingspagina van de student en op jouw sessiepagina.
Elke sessie van een herhalende klas krijgt zijn eigen geplande meeting.
Zoom verwijderen (Disconnect)
Ga naar /mentor/settings/connections
De Connections-pagina.
Klik 'Disconnect' op de Zoom-rij
We verwijderen de versleutelde Zoom-tokens direct uit onze database en stoppen met het aanmaken van nieuwe meetings.
Optioneel ook bij Zoom intrekken
Log in op marketplace.zoom.us → 'Manage' → 'Added Apps' → trek MoveMentors in. Daarmee verdwijnt onze app uit je lijst geïnstalleerde apps aan de Zoom-kant.
Eerder aangemaakte meetings op je Zoom-account blijven staan; we verwijderen ze niet met terugwerkende kracht. Wil je opruimen, doe dat vanuit je Zoom-account.
Welke credentials we bewaren
- Google: een OAuth refresh token en een access token. Versleuteld in rust met AES-256-GCM. We verversen access tokens automatisch zonder je opnieuw om toestemming te vragen.
- Apple: je Apple ID-mail en het app-specifieke wachtwoord. Versleuteld in rust met AES-256-GCM. Gebruikt voor CalDAV-verzoeken aan
caldav.icloud.com. - Zoom: een OAuth refresh token en een access token. Versleuteld in rust met AES-256-GCM. Zoom roteert refresh tokens bij elke refresh; we slaan de geroteerde token telkens opnieuw op.
Niets wordt in klare tekst gelogd, over onveilige verbindingen verzonden, of met anderen gedeeld. Je kunt de toegang op elk moment intrekken vanuit de instellingen van de provider:
- Google: myaccount.google.com → Beveiliging → Apps van derden
- Apple: appleid.apple.com → App-specifieke wachtwoorden → trek die van MoveMentors in
- Zoom: marketplace.zoom.us → Manage → Added Apps → trek MoveMentors in
Wat wordt wanneer gesynchroniseerd
- Boeking bevestigd → Meet- of Zoom-link aangemaakt, agenda-event toegevoegd (voor online klassen op Google), bevestigingsmail gaat de deur uit
- Boeking geannuleerd → agenda-event verwijderd (alleen Google; Apple is alleen-lezen vanuit onze kant)
- Klastijd verandert → het event in je agenda verplaatst (alleen Google)
- Je verbreekt de verbinding → bestaande events blijven in je agenda; we sturen geen nieuwe meer; versleutelde credentials worden verwijderd
Updates lopen vrijwel realtime via achtergrondtaken.
Veelgestelde vragen
Kan ik koppelen met Outlook? Nog niet native. Workaround: abonneer je op de .ics-feed van je lesrooster via de Connections-pagina (zie "For other calendar apps" onderaan). Dat werkt in Outlook, Fastmail, ProtonCalendar of elke app die webcal-abonnementen ondersteunt.
Mijn events verschijnen in de verkeerde tijdzone. Hoogstwaarschijnlijk verschilt de tijdzone van je agenda-account van die van de klas. Het event wordt opgeslagen in de tijdzone van de klas (correct); je agenda toont het omgerekend naar je accounttijdzone (correct). Het voelt "verkeerd" als je reist. Pas de tijdzone van je agenda-app aan als je permanent verhuisd bent.
Sync werkt niet meer / events zijn verouderd. Meest voorkomende oorzaak: token verlopen of ingetrokken. Ga naar /mentor/settings/connections; de rij van de getroffen provider toont "Not connected". Opnieuw koppelen.
Kunnen mijn fysieke boekingen ook in mijn agenda komen? Op dit moment schrijft Google alleen boekingen van online klassen in je agenda (zodat de Meet-link op het event leeft). Voor fysieke klassen: abonneer je op de .ics-feed van je lesrooster (Connections-pagina → onderaan); die bevat alles wat je geeft.
40-minuten Zoom-limiet zit in de weg? Het gratis Zoom-plan limiteert groepsmeetings tot 40 minuten. Opties: upgrade je Zoom naar Pro (circa 15 $/maand) om de limiet op te heffen, of zet de klas op Google Meet (geen tijdslimiet op het gratis Google-plan).
Volgende stappen
- Roosters en herhaling: hoe je klastijden instelt.
- Agenda-sync voor studenten: de tegenhanger aan studentenkant.