La página de Conexiones en /mentor/settings/connections es donde vinculas tu calendario y tus proveedores de vídeo a MoveMentors. Hoy conviven tres integraciones: Google Calendar (con Meet), Apple Calendar y Zoom.
Qué hace cada conexión
| Proveedor | Qué lee | Qué escribe |
|---|---|---|
| Google Calendar y Meet | Tu disponibilidad del calendario que elijas | Las reservas de clases online aparecen en tu calendario con un enlace de Google Meet |
| Apple Calendar | Tu disponibilidad de iCloud | Nada de vuelta a iCloud (la API de Apple no lo permite como la de Google) |
| Zoom | Nada | Cuando una reserva se confirma en una clase configurada con Zoom, creamos una reunión en tu cuenta de Zoom |
Puedes conectar cualquier combinación. Si conectas Google y Zoom a la vez, podrás elegir por clase cuál de los dos hospeda la sesión.
Google Calendar y Meet
Ve a /mentor/settings/connections
La página de Conexiones de tu panel de mentor.
Pulsa 'Connect Google'
Te redirigiremos a la pantalla de consentimiento OAuth de Google.
Elige tu cuenta de Google y concede permisos
Pedimos dos permisos: leer eventos del calendario (para tu disponibilidad) y crear eventos (para reservas y enlaces de Meet). Nada más.
Elige un calendario (si tienes varios)
Por defecto usamos el principal. Si prefieres un calendario "MoveMentors" dedicado, créalo primero en Google Calendar y luego cámbialo desde la página de conexiones.
Una vez conectado, cualquier clase que marques como online generará automáticamente un enlace de Google Meet cuando un alumno reserve. El enlace aparece en el correo de confirmación, en la página de confirmación de la reserva y en el evento de Google Calendar de esa sesión.
Apple Calendar
Apple no ofrece OAuth para acceso a calendario de terceros. En su lugar, generas una "contraseña específica de app" desde tu cuenta de Apple ID y la pegas en MoveMentors. La verificación en dos pasos en tu Apple ID debe estar activada antes de poder crear contraseñas específicas de app.
Inicia sesión en appleid.apple.com
Usa el mismo Apple ID que usas para iCloud Calendar.
Abre 'Iniciar sesión y seguridad'
En la barra lateral.
Pulsa 'Contraseñas específicas de app'
Si no ves esta opción, la verificación en dos pasos no está activada. Actívala primero (Ajustes → 'Seguridad de la cuenta' → 'Verificación en dos pasos') y vuelve.
Pulsa 'Generar una contraseña específica de app'
O el botón '+'.
Etiquétala como 'MoveMentors' y pulsa Crear
Apple puede pedirte que vuelvas a introducir tu contraseña de Apple ID para confirmar.
Copia la contraseña que Apple te muestra
Tiene la forma
xxxx-xxxx-xxxx-xxxx. La verás solo una vez, y Apple no te dejará volver a consultarla. Si la pierdes, genera una nueva y revoca la anterior.Vuelve a MoveMentors y ve a /mentor/settings/connections
Pulsa 'Connect Apple'. Introduce tu correo de Apple ID y la contraseña específica de app que acabas de copiar. Pulsa Connect.
Si la conexión falla, las causas más comunes son:
- Formato de contraseña incorrecto: debe ser la contraseña específica de app con formato
xxxx-xxxx-xxxx-xxxx, no tu contraseña real de Apple ID. - Verificación en dos pasos no activa: ver Paso 3.
- Contraseña caducada o revocada: Apple invalida las contraseñas específicas de app cuando cambias tu contraseña de Apple ID o las revocas manualmente. Genera una nueva.
Zoom
La integración de Zoom con MoveMentors crea una reunión de Zoom en tu cuenta cada vez que se confirma una reserva en una clase configurada con Zoom como proveedor de vídeo. Añadir, usar y eliminar la app se inicia siempre desde MoveMentors.
Añadir Zoom (Connect)
Necesitas una cuenta de Zoom
Una cuenta gratuita funciona (límite de 40 minutos en reuniones grupales). Un plan Pro de pago elimina el límite. Regístrate en zoom.us si aún no tienes cuenta.
Ve a /mentor/settings/connections y pulsa 'Connect Zoom'
Te redirigiremos a la pantalla de consentimiento OAuth de Zoom.
Concede los permisos solicitados
Tres permisos: crear reuniones en tu cuenta (
meeting:write:meeting), leer detalles de reuniones (meeting:read:meeting) y leer tu perfil básico (user:read:user) para que la información del anfitrión sea correcta. Nada más.Listo
Volverás a MoveMentors con la fila de Zoom mostrando 'Connected as <tu nombre>'.
Usar Zoom (por clase)
Para cada clase online que crees, puedes elegir Google Meet o Zoom como proveedor de vídeo. Si solo conectaste uno de los dos, se usa automáticamente, sin selector.
Cuando un alumno reserva una clase con Zoom, MoveMentors:
- Crea una reunión programada en tu cuenta de Zoom (tipo 2: programada, con join-before-host activado, sin sala de espera).
- Guarda la URL de la reunión en la reserva.
- Envía el enlace en el correo de confirmación.
- Lo muestra en la página de confirmación del alumno y en tu página de gestión de la sesión.
Cada sesión de una clase recurrente recibe su propia reunión programada.
Eliminar Zoom (Disconnect)
Ve a /mentor/settings/connections
La página de Conexiones.
Pulsa 'Disconnect' en la fila de Zoom
Borramos inmediatamente los tokens cifrados de Zoom de nuestra base de datos y dejamos de crear nuevas reuniones.
Opcionalmente, revoca también desde Zoom
Inicia sesión en marketplace.zoom.us → 'Manage' → 'Added Apps' → revoca MoveMentors. Esto retira nuestra app de tu lista de apps instaladas en el lado de Zoom.
Las reuniones pasadas que ya se crearon en tu cuenta de Zoom permanecen ahí; no las borramos retroactivamente. Si quieres limpiarlas, hazlo desde tu cuenta de Zoom.
Qué credenciales guardamos
- Google: un refresh token OAuth y un access token. Cifrados en reposo con AES-256-GCM. Refrescamos el access token automáticamente sin volver a pedirte permisos.
- Apple: tu correo de Apple ID y la contraseña específica de app. Cifrados en reposo con AES-256-GCM. Se usan para peticiones CalDAV a
caldav.icloud.com. - Zoom: un refresh token OAuth y un access token. Cifrados en reposo con AES-256-GCM. Zoom rota el refresh token en cada refresco; lo re-persistimos en cada rotación.
Nada se registra en texto plano, se envía por conexiones inseguras ni se comparte con nadie. Puedes revocar el acceso en cualquier momento desde los ajustes de cada proveedor:
- Google: myaccount.google.com → Seguridad → Aplicaciones de terceros
- Apple: appleid.apple.com → Contraseñas específicas de app → revoca la de MoveMentors
- Zoom: marketplace.zoom.us → Manage → Added Apps → revoca MoveMentors
Qué se sincroniza y cuándo
- Una reserva se confirma → se genera el enlace de Meet o Zoom, se añade el evento al calendario (para clases online en Google), sale el correo de confirmación
- Una reserva se cancela → se elimina el evento del calendario (solo Google; Apple es de solo lectura por nuestra parte)
- Cambia el horario de una clase → el evento de tu calendario se mueve (solo Google)
- Te desconectas → los eventos ya creados se quedan en tu calendario; dejamos de empujar nuevos; las credenciales cifradas se borran
Las actualizaciones se aplican casi en tiempo real mediante trabajos en segundo plano.
Preguntas comunes
¿Puedo sincronizar con Outlook? Aún no de forma nativa. Alternativa: suscríbete al feed .ics de tu horario de enseñanza desde la página de Conexiones (mira "For other calendar apps" al final de la página). Funciona en Outlook, Fastmail, ProtonCalendar o cualquier app que admita suscripciones webcal.
Mis eventos del calendario aparecen en la zona horaria equivocada. Lo más probable es que la zona horaria de tu cuenta de calendario difiera de la de la clase. El evento se guarda en la zona horaria de la clase (correcto); tu calendario lo muestra convertido a tu zona horaria de cuenta (correcto). Parece "raro" cuando viajas. Ajusta la zona horaria de tu app de calendario si te has mudado de forma permanente.
La sincronización dejó de funcionar / los eventos están desactualizados. Causa más común: el token caducó o fue revocado. Ve a /mentor/settings/connections; la fila del proveedor afectado mostrará "Not connected". Vuelve a conectar.
¿Pueden aparecer también mis reservas presenciales en mi calendario? Ahora mismo Google solo escribe en tu calendario las reservas de clases online (para que el enlace de Meet viva en el evento). Para clases presenciales, suscríbete al feed .ics de tu horario de enseñanza (página de Conexiones → final), que incluye todo lo que enseñas.
¿Te molesta el límite de 40 minutos de Zoom? El plan gratuito de Zoom limita las reuniones grupales a 40 minutos. Opciones: actualiza tu Zoom a Pro (unos 15 $/mes) para eliminar el límite, o cambia la clase a Google Meet (que no tiene límite de tiempo en el plan gratuito de Google).
Siguientes pasos
- Horarios y recurrencia: cómo configurar los horarios de tus clases.
- Sincronización de calendario para estudiantes: el equivalente para alumnos.