La pagina Connections su /mentor/settings/connections è dove colleghi il tuo calendario e i tuoi provider video a MoveMentors. Oggi convivono tre integrazioni: Google Calendar (con Meet), Apple Calendar e Zoom.
Cosa fa ogni connessione
| Provider | Cosa legge | Cosa scrive |
|---|---|---|
| Google Calendar e Meet | Le tue fasce occupate dal calendario che scegli | Le prenotazioni di lezioni online appaiono nel tuo calendario con un link Google Meet |
| Apple Calendar | Le tue fasce occupate da iCloud | Niente in ritorno verso iCloud (l'API di Apple non lo permette come quella di Google) |
| Zoom | Niente | Quando una prenotazione si conferma su una lezione impostata su Zoom, creiamo una riunione sul tuo account Zoom |
Puoi collegare qualsiasi combinazione. Se colleghi sia Google che Zoom, potrai scegliere per ogni lezione quale provider video la ospita.
Google Calendar e Meet
Vai su /mentor/settings/connections
La pagina Connections del tuo cruscotto mentor.
Clicca 'Connect Google'
Verrai reindirizzato alla schermata di consenso OAuth di Google.
Scegli il tuo account Google e concedi i permessi
Chiediamo due scope: leggere gli eventi del calendario (per le fasce occupate) e creare eventi (per prenotazioni e link Meet). Nient'altro.
Scegli un calendario (se ne hai più di uno)
Di default usiamo quello principale. Se preferisci un calendario "MoveMentors" dedicato, crealo prima in Google Calendar e poi selezionalo dalla pagina Connections.
Una volta collegato, ogni lezione che marchi come online genererà automaticamente un link Google Meet alla prenotazione di uno studente. Il link va nell'email di conferma, nella pagina di conferma prenotazione e nell'evento Google Calendar di quella sessione.
Apple Calendar
Apple non offre OAuth per l'accesso al calendario di terze parti. Invece generi una "password specifica per l'app" dal tuo account Apple ID e la incolli in MoveMentors. L'autenticazione a due fattori sul tuo Apple ID deve essere attiva prima di poter creare password specifiche per l'app.
Accedi a appleid.apple.com
Usa lo stesso Apple ID che usi per iCloud Calendar.
Apri 'Accesso e sicurezza'
Nella barra laterale.
Clicca 'Password specifiche per l'app'
Se non vedi questa opzione, l'autenticazione a due fattori non è attiva. Attivala prima (Impostazioni → 'Sicurezza account' → 'Autenticazione a due fattori') e torna qui.
Clicca 'Genera una password specifica per l'app'
O il pulsante '+'.
Etichettala 'MoveMentors' e clicca Crea
Apple potrebbe chiederti di reinserire la tua password Apple ID per confermare.
Copia la password che Apple mostra
Ha la forma
xxxx-xxxx-xxxx-xxxx. La vedrai solo una volta, e Apple non te la farà rivedere. Se la perdi, generane una nuova e revoca la vecchia.Torna in MoveMentors, vai su /mentor/settings/connections
Clicca 'Connect Apple'. Inserisci la tua email Apple ID e la password specifica per l'app che hai appena copiato. Clicca Connect.
Se la connessione fallisce, i motivi più comuni sono:
- Formato password sbagliato: deve essere la password specifica per l'app nel formato
xxxx-xxxx-xxxx-xxxx, non la tua vera password Apple ID. - Due fattori non attivi: vedi Passo 3.
- Password scaduta o revocata: Apple invalida le password specifiche per l'app quando cambi la password Apple ID o le revochi manualmente. Generane una nuova.
Zoom
L'integrazione Zoom di MoveMentors crea una riunione Zoom sul tuo account ogni volta che si conferma una prenotazione per una lezione impostata su Zoom come provider video. Aggiungere, usare e rimuovere l'app sono tutte azioni che parti da MoveMentors.
Aggiungere Zoom (Connect)
Ti serve un account Zoom
Un account Zoom gratuito basta (limite di 40 minuti sulle riunioni di gruppo). Un piano Pro a pagamento toglie il limite. Registrati su zoom.us se non hai ancora un account.
Vai su /mentor/settings/connections e clicca 'Connect Zoom'
Verrai reindirizzato alla schermata di consenso OAuth di Zoom.
Concedi i permessi richiesti
Tre scope: creare riunioni sul tuo account (
meeting:write:meeting), leggere i dettagli delle riunioni (meeting:read:meeting) e leggere il tuo profilo di base (user:read:user) così le info dell'host sono corrette. Nient'altro.Fatto
Tornerai a MoveMentors con la riga Zoom che mostra 'Connected as <il tuo nome>'.
Usare Zoom (per lezione)
Per ogni lezione online che crei, puoi scegliere Google Meet o Zoom come provider video. Se hai collegato solo uno dei due, quello viene usato automaticamente, senza selettore.
Quando uno studente prenota una lezione Zoom, MoveMentors:
- Crea una riunione pianificata sul tuo account Zoom (tipo 2: pianificata, join-before-host attivo, niente sala d'attesa).
- Salva l'URL della riunione sulla prenotazione.
- Invia il link nell'email di conferma.
- Mostra l'URL nella pagina di conferma dello studente e nella tua pagina di gestione della sessione.
Ogni sessione di una lezione ricorrente riceve la sua riunione pianificata.
Rimuovere Zoom (Disconnect)
Vai su /mentor/settings/connections
La pagina Connections.
Clicca 'Disconnect' sulla riga Zoom
Cancelliamo immediatamente i token Zoom cifrati dal nostro database e smettiamo di creare nuove riunioni.
Opzionalmente revoca anche lato Zoom
Accedi su marketplace.zoom.us → 'Manage' → 'Added Apps' → revoca MoveMentors. Questo rimuove la nostra app dalla tua lista di app installate sul lato Zoom.
Le riunioni passate già create sul tuo account Zoom restano lì; non le cancelliamo retroattivamente. Se vuoi fare pulizia, fallo dal tuo account Zoom.
Quali credenziali memorizziamo
- Google: un refresh token OAuth e un access token. Cifrati a riposo con AES-256-GCM. Rinnoviamo gli access token automaticamente senza richiederti il consenso di nuovo.
- Apple: la tua email Apple ID e la password specifica per l'app. Cifrate a riposo con AES-256-GCM. Usate per richieste CalDAV a
caldav.icloud.com. - Zoom: un refresh token OAuth e un access token. Cifrati a riposo con AES-256-GCM. Zoom ruota il refresh token a ogni refresh; lo ri-persistiamo a ogni rotazione.
Niente viene loggato in chiaro, inviato su connessioni insicure, o condiviso con nessuno. Puoi revocare l'accesso in qualsiasi momento dalle impostazioni del provider:
- Google: myaccount.google.com → Sicurezza → App di terze parti
- Apple: appleid.apple.com → Password specifiche per l'app → revoca quella di MoveMentors
- Zoom: marketplace.zoom.us → Manage → Added Apps → revoca MoveMentors
Cosa si sincronizza e quando
- Una prenotazione si conferma → link Meet o Zoom generato, evento aggiunto al calendario (per lezioni online su Google), email di conferma parte
- Una prenotazione si cancella → evento rimosso dal calendario (solo Google; Apple è solo lettura dal nostro lato)
- L'orario di una lezione cambia → l'evento nel tuo calendario si sposta (solo Google)
- Ti disconnetti → gli eventi già creati restano nel calendario; smettiamo di pushare nuovi; le credenziali cifrate vengono cancellate
Gli aggiornamenti avvengono quasi in tempo reale tramite job in background.
Domande comuni
Posso sincronizzare con Outlook? Non ancora in modo nativo. Workaround: iscriviti al feed .ics del tuo planning dalla pagina Connections (vedi "For other calendar apps" in fondo). Funziona in Outlook, Fastmail, ProtonCalendar o qualsiasi app che supporti gli abbonamenti webcal.
I miei eventi appaiono nel fuso orario sbagliato. Molto probabile che il fuso del tuo account calendario differisca da quello della lezione. L'evento è salvato nel fuso della lezione (corretto); il tuo calendario lo mostra convertito nel fuso del tuo account (corretto). Sembra "sbagliato" quando viaggi. Aggiusta il fuso dell'app calendario se ti sei trasferito.
La sync non funziona più / eventi datati. Causa più frequente: token scaduto o revocato. Vai su /mentor/settings/connections; la riga del provider colpito mostra "Not connected". Riconnetti.
Anche le mie prenotazioni in presenza possono apparire nel calendario? Per ora Google scrive nel tuo calendario solo le prenotazioni di lezioni online (per ancorare il link Meet all'evento). Per le lezioni in presenza, iscriviti al feed .ics del tuo planning (pagina Connections → in fondo), che include tutto ciò che insegni.
Il limite di 40 minuti di Zoom è un problema? Il piano gratuito di Zoom limita le riunioni di gruppo a 40 minuti. Opzioni: passa a Zoom Pro (circa 15 $/mese) per togliere il limite, oppure passa la lezione a Google Meet (nessun limite di tempo sul piano gratuito di Google).
Passi successivi
- Orari e ricorrenza: come impostare gli orari delle tue lezioni.
- Sincronizzazione calendario per studenti: l'equivalente lato studenti.