Issues de calendar sync

Calendar sync depende de third-party APIs y tokens que ocasional break.

Eventos no aparecen

1. Check conexión

/mentor/settings/connections muestra status.

• Connected: green. Syncing.
• Needs reconnection: yellow/red. Click "Reconnect" + re-auth.

Connected + missing → next.

2. Calendario correcto picked?

Maybe connected primary pero events pushed a sub-calendar.

Google: sub-calendars en sidebar; check "MoveMentors" visible. Apple: sub-calendars under account; same idea.

3. Recently created take few min

Push async; ~5 min expected.

1 hora: wrong.

4. Force re-sync

/mentor/settings/connections → "Sync now". Re-pushes upcoming.

Falla → error message indica qué.

Wrong time

Most común: timezone mismatch.

Class timezone set en creation (default profile). Event anchored a esa. Tu calendar converts a local.

Traveled y app shows different: events pre-travel still show original tz, converted a current display tz. Correct pero confusing.

Verify: open event en Google/Apple. Details show original tz ("11am Berlin, 5am NYC"). No show: original class tz wrong; edit class y re-save.

Cancellations no remove events

Cancel session en MoveMentors → event delete en calendar.

No delete:

1. Check /mentor/settings/connections connection status.
2. Wait 5 min; async.
3. Still there: delete manually.

Bookings changing (party size, names) update description but no move event.

Calendar lleno de duplicados

Sync que started antes de clean disconnect. Workaround:

1. Delete events manually (o entire sub-calendar si dedicated).
2. Disconnect MoveMentors.
3. Reconnect.
4. Force clean re-sync.

Duplicados keep appearing: email soporte.

Google: "Cannot access your calendar"

OAuth token expired o revoked.

Fix:

1. myaccount.google.com/security.
2. "Third-party apps with account access".
3. Si MoveMentors authorized, remove (re-authorize next step).
4. Back to MoveMentors. /mentor/settings/connections → "Reconnect Google".
5. Re-authorize.

Apple: "Authentication failed"

App-specific password changed o 2FA refreshed.

Fix:

1. appleid.apple.com → "App-Specific Passwords" → delete old.
2. Generate new app-specific.
3. MoveMentors. /mentor/settings/connections → "Reconnect Apple" con new.

Two-way confusion

NO tenemos two-way. Cambios en Google/Apple no propagate a MoveMentors.

Accidental move: class en MoveMentors unchanged. Next sync de nosotros moves event back.

Para actually cambiar time, edit la clase en MoveMentors.

Studiantes no recibieron mis cambios

Sync es entre MoveMentors y tu app. No afecta lo que estudiantes ven.

Si cambias session time:

• Class detail updates inmediato.
• Estudiantes booked reciben email.
• Their .ics already imported NO auto-update; tendrían re-download.

Working on student-side calendar subscription (webcal:// URL). No live yet.

"Unknown organizer" en eventos

Organiser field sometimes blank o generic dependiendo de calendar setup. Event funciona (correct times, location). Quirk de cómo Google/Apple render external calendars.

Edit manually to set yourself organizer si bothers, but auto-imported have generic.

Preguntas frecuentes

¿Outlook? No nativo. Workaround: connect Google a MoveMentors, luego Outlook a Google.

¿Phone shows; desktop no? Probably sub-calendar hidden en desktop. Check left sidebar toggle.

¿Sync stops after weeks? Most often OAuth expired. Reconnect.

¿Missing para una clase específica pero otras presentes? Check si class active en MoveMentors. Inactive no push. Also location set; missing breaks.

Próximos pasos

• Calendar sync para mentores.
• Schedules y recurrentes.