La sincronizzazione del calendario dipende da API di terze parti e token di autenticazione che occasionalmente si rompono. Questo articolo copre i problemi più comuni.
I miei eventi non appaiono
1. Controlla la connessione
/mentor/settings/connections mostra lo stato del tuo calendario connesso.
- Connesso: indicatore verde. Gli eventi dovrebbero essere in sincronizzazione.
- Necessita riconnessione: indicatore giallo / rosso. Clicca "Riconnetti" e ri-autorizza.
Se lo stato è connesso ma gli eventi mancano, vai avanti.
2. Controlla di aver scelto il calendario giusto
Potresti esserti connesso al tuo calendario primario ma gli eventi vengono inviati a un sotto-calendario.
In Google Calendar, i sotto-calendari sono elencati nella sidebar a sinistra; assicurati che "MoveMentors" o qualunque calendario hai scelto sia visibile (casella spuntata).
In Apple Calendar, i sotto-calendari appaiono sotto il tuo account. Stessa idea; assicurati che quello giusto sia visibile.
3. Gli eventi appena creati richiedono qualche minuto
Inviamo nuovi eventi in modo asincrono; aspettati un ritardo di 5 minuti dalla creazione della lezione all'apparizione nel calendario.
Se hai creato una lezione un'ora fa e l'evento non è ancora lì, qualcosa è sbagliato; vai avanti.
4. Forza una ri-sincronizzazione
/mentor/settings/connections → "Sincronizza ora". Questo re-invia tutti gli eventi in arrivo.
Se la ri-sincronizzazione fallisce, il messaggio di errore indicherà cosa c'è di sbagliato.
Gli eventi appaiono all'orario sbagliato
Causa più comune: mismatch di fuso orario.
Il fuso orario della lezione è impostato quando crei la lezione (predefinito è il fuso del tuo profilo). L'ora di inizio dell'evento è ancorata a quel fuso. Quando la tua app calendario mostra l'evento, lo converte nel fuso locale del tuo calendario.
Se hai viaggiato e la tua app calendario ora mostra un fuso diverso da casa, gli eventi da prima del viaggio appaiono ancora nel loro fuso originale, convertiti nel tuo fuso di visualizzazione attuale. È comportamento corretto ma confondente.
Per verificare: apri l'evento in Google o Apple Calendar. I dettagli dell'evento dovrebbero mostrare il fuso originale (es. "11:00 ora di Berlino, 5:00 ora di New York"). Se non lo mostra, il fuso originale della lezione è sbagliato; modifica la lezione su MoveMentors e ri-salva.
Le cancellazioni non rimuovono gli eventi
Se cancelli una sessione in MoveMentors, l'evento corrispondente nel tuo calendario dovrebbe essere eliminato.
Se non lo fa:
- Controlla /mentor/settings/connections per lo stato della connessione.
- Aspetta 5 minuti; l'eliminazione è asincrona.
- Se è ancora lì, eliminalo manualmente dal tuo calendario.
I cambiamenti di prenotazione (dimensione del gruppo, nomi partecipanti) aggiornano la descrizione dell'evento ma non spostano l'evento.
Il mio calendario è pieno di eventi duplicati
Di solito una sincronizzazione iniziata prima che avvenisse una disconnessione pulita. Soluzione:
- Elimina manualmente gli eventi (o elimina l'intero sotto-calendario se ne hai usato uno dedicato).
- Disconnettiti da MoveMentors.
- Riconnettiti.
- Forza una ri-sincronizzazione pulita.
Se i duplicati continuano ad apparire, qualcosa è sbagliato; scrivi al supporto con dettagli.
Google Calendar: "Impossibile accedere al tuo calendario"
Il token OAuth di Google potrebbe essere scaduto o essere stato revocato.
Per risolvere:
- Vai su myaccount.google.com/security.
- Trova "App di terze parti con accesso all'account".
- Controlla se MoveMentors è ancora autorizzato. Se sì, rimuovi l'accesso (ri-autorizzerai al prossimo passo).
- Torna a MoveMentors. /mentor/settings/connections → "Riconnetti Google".
- Ri-autorizza.
Apple Calendar: "Autenticazione fallita"
La password specifica per l'app di Apple potrebbe essere cambiata o la tua configurazione 2FA potrebbe essersi aggiornata.
Per risolvere:
- Vai su appleid.apple.com → "App-Specific Passwords" → elimina la vecchia password MoveMentors.
- Genera una nuova password specifica per l'app.
- Torna a MoveMentors. /mentor/settings/connections → "Riconnetti Apple" con la nuova password.
Confusione sulla sincronizzazione bidirezionale
NON abbiamo sincronizzazione bidirezionale. Le modifiche che fai in Google o Apple Calendar (spostare un evento, eliminarlo, ecc.) non si propagano a MoveMentors.
Se hai accidentalmente spostato un evento nel tuo calendario:
- La lezione in MoveMentors è invariata.
- La prossima sincronizzazione da noi sposterà l'evento dove dovrebbe stare.
Per cambiare effettivamente un'ora di sessione, modifica la lezione in MoveMentors. La modifica viene inviata al tuo calendario.
Gli studenti non hanno ricevuto i miei cambi di calendario
La sincronizzazione del calendario è tra MoveMentors e la tua app calendario. Non influisce su ciò che vedono gli studenti.
Se cambi un'ora di sessione:
- La pagina di dettaglio della lezione si aggiorna immediatamente.
- Gli studenti prenotati sulla sessione interessata ricevono un'email sul cambio.
- I loro file calendario .ics (già nei loro calendari personali) NON si auto-aggiornano; dovrebbero ri-scaricarli.
Stiamo lavorando a una sottoscrizione calendario lato studente (un URL webcal:// a cui possono iscriversi così le modifiche fluiscono automaticamente). Non ancora attivo.
Perché il mio calendario mostra "Organizzatore sconosciuto" per gli eventi MoveMentors
I campi organizzatore degli eventi sono talvolta vuoti o generici a seconda della tua configurazione di calendario. L'evento funziona comunque (orari corretti, location, ecc.); la visualizzazione dell'organizzatore è una stranezza di come Google / Apple renderizzano i calendari esterni.
Puoi modificare manualmente l'evento per impostare te stesso come organizzatore se ti dà fastidio, ma gli eventi auto-importati hanno un organizzatore generico.
Domande frequenti
Posso usare il calendario di Outlook? Non nativamente. Soluzione: collega Google Calendar a MoveMentors, poi collega Outlook a Google Calendar (Outlook lo supporta). La catena funziona.
Il mio telefono mostra gli eventi; il mio calendario desktop no. Probabilmente il sotto-calendario è nascosto sul desktop. Controlla la lista dei calendari nella sidebar a sinistra e attiva la visibilità.
La sincronizzazione smette di funzionare dopo qualche settimana. Più spesso il token OAuth è scaduto. Riconnetti.
Gli eventi mancano per una lezione specifica ma sono presenti per altre. Controlla se la lezione è attiva in MoveMentors. Le lezioni inattive non inviano eventi. Controlla anche che la location della lezione sia impostata; le location mancanti a volte rompono la generazione dell'evento.
Prossimi passi
- Sincronizzazione del calendario per mentor: guida di configurazione.
- Calendari e ricorrenze: come funzionano i calendari delle lezioni.