La page Connections sur /mentor/settings/connections est l'endroit où tu relies ton calendrier et tes fournisseurs vidéo à MoveMentors. Trois intégrations y vivent aujourd'hui : Google Calendar (avec Meet), Apple Calendar et Zoom.
Ce que fait chaque connexion
| Fournisseur | Ce qu'il lit | Ce qu'il écrit |
|---|---|---|
| Google Calendar et Meet | Tes plages occupées sur le calendrier que tu choisis | Les réservations de cours en ligne apparaissent dans ton calendrier avec un lien Google Meet |
| Apple Calendar | Tes plages occupées sur iCloud | Rien en retour vers iCloud (l'API d'Apple ne le permet pas comme celle de Google) |
| Zoom | Rien | Quand une réservation est confirmée sur un cours configuré en Zoom, on crée une réunion sur ton compte Zoom |
Tu peux connecter n'importe quelle combinaison. Si tu connectes Google et Zoom en même temps, tu pourras choisir cours par cours quel fournisseur vidéo l'héberge.
Google Calendar et Meet
Va sur /mentor/settings/connections
La page Connections de ton tableau de bord mentor.
Clique 'Connect Google'
Tu seras redirigé vers l'écran de consentement OAuth de Google.
Choisis ton compte Google et donne la permission
On demande deux scopes : lire les événements du calendrier (pour les plages occupées) et créer des événements (pour les réservations et les liens Meet). Rien de plus.
Choisis un calendrier (si tu en as plusieurs)
Par défaut on utilise le principal. Si tu préfères un calendrier "MoveMentors" dédié, crée-le d'abord dans Google Calendar puis sélectionne-le depuis la page Connections.
Une fois connecté, tout cours que tu marques en ligne générera automatiquement un lien Google Meet quand un élève réserve. Le lien va dans l'e-mail de confirmation, sur la page de confirmation de réservation et dans l'événement Google Calendar de la session.
Apple Calendar
Apple ne propose pas OAuth pour l'accès calendrier tiers. À la place, tu génères un "mot de passe spécifique à l'app" depuis ton compte Apple ID et tu le colles dans MoveMentors. L'authentification à deux facteurs sur ton Apple ID doit être activée avant de pouvoir créer des mots de passe spécifiques à l'app.
Connecte-toi sur appleid.apple.com
Utilise le même Apple ID que pour iCloud Calendar.
Ouvre 'Connexion et sécurité'
Dans la barre latérale.
Clique 'Mots de passe spécifiques à l'app'
Si tu ne vois pas cette option, la double authentification n'est pas activée. Active-la d'abord (Réglages → 'Sécurité du compte' → 'Authentification à deux facteurs') puis reviens.
Clique 'Générer un mot de passe spécifique à l'app'
Ou le bouton '+'.
Nomme-le 'MoveMentors' et clique Créer
Apple peut te redemander ton mot de passe Apple ID pour confirmer.
Copie le mot de passe affiché par Apple
Il a la forme
xxxx-xxxx-xxxx-xxxx. Tu ne le verras qu'une seule fois, et Apple ne te le réaffichera pas. Si tu le perds, génère-en un nouveau et révoque l'ancien.Retour dans MoveMentors, va sur /mentor/settings/connections
Clique 'Connect Apple'. Saisis ton e-mail Apple ID et le mot de passe spécifique à l'app que tu viens de copier. Clique Connect.
Si la connexion échoue, les raisons les plus courantes sont :
- Mauvais format de mot de passe : doit être le mot de passe spécifique à l'app au format
xxxx-xxxx-xxxx-xxxx, pas ton vrai mot de passe Apple ID. - Double authentification non activée : voir l'étape 3.
- Mot de passe expiré ou révoqué : Apple invalide les mots de passe spécifiques à l'app quand tu changes ton mot de passe Apple ID ou que tu les révoques manuellement. Génères-en un nouveau.
Zoom
L'intégration Zoom de MoveMentors crée une réunion Zoom sur ton compte chaque fois qu'une réservation est confirmée pour un cours dont le fournisseur vidéo est Zoom. Ajouter, utiliser et retirer l'app sont toutes des actions initiées depuis MoveMentors.
Ajouter Zoom (Connect)
Il te faut un compte Zoom
Un compte Zoom gratuit suffit (limite de 40 minutes sur les réunions de groupe). Un plan Pro payant lève la limite. Inscris-toi sur zoom.us si tu n'as pas encore de compte.
Va sur /mentor/settings/connections et clique 'Connect Zoom'
Tu seras redirigé vers l'écran de consentement OAuth de Zoom.
Donne les permissions demandées
Trois scopes : créer des réunions sur ton compte (
meeting:write:meeting), lire les détails des réunions (meeting:read:meeting) et lire ton profil de base (user:read:user) pour que les infos d'hôte soient exactes. Rien de plus.C'est fait
Tu reviendras dans MoveMentors avec la ligne Zoom affichant 'Connected as <ton nom>'.
Utiliser Zoom (par cours)
Pour chaque cours en ligne que tu crées, tu peux choisir Google Meet ou Zoom comme fournisseur vidéo. Si tu n'en as connecté qu'un seul, il est utilisé automatiquement, sans sélecteur.
Quand un élève réserve un cours Zoom, MoveMentors :
- Crée une réunion planifiée sur ton compte Zoom (type 2 : planifiée, join-before-host activé, pas de salle d'attente).
- Stocke l'URL de la réunion sur la réservation.
- Envoie le lien dans l'e-mail de confirmation.
- Affiche l'URL sur la page de confirmation de l'élève et sur ta page de gestion de session.
Chaque session d'un cours récurrent obtient sa propre réunion planifiée.
Retirer Zoom (Disconnect)
Va sur /mentor/settings/connections
La page Connections.
Clique 'Disconnect' sur la ligne Zoom
On supprime immédiatement les tokens Zoom chiffrés de notre base et on arrête de créer de nouvelles réunions.
Optionnellement, révoque aussi côté Zoom
Connecte-toi sur marketplace.zoom.us → 'Manage' → 'Added Apps' → révoque MoveMentors. Ça enlève notre app de ta liste d'apps installées côté Zoom.
Les réunions passées déjà créées sur ton compte Zoom y restent ; on ne les supprime pas rétroactivement. Si tu veux faire le ménage, fais-le depuis ton compte Zoom.
Quelles informations d'identification on stocke
- Google : un refresh token OAuth et un access token. Chiffrés au repos avec AES-256-GCM. On rafraîchit les access tokens automatiquement sans te redemander.
- Apple : ton e-mail Apple ID et le mot de passe spécifique à l'app. Chiffrés au repos avec AES-256-GCM. Utilisés pour des requêtes CalDAV vers
caldav.icloud.com. - Zoom : un refresh token OAuth et un access token. Chiffrés au repos avec AES-256-GCM. Zoom fait tourner le refresh token à chaque rafraîchissement ; on re-persiste à chaque rotation.
Rien n'est journalisé en clair, envoyé sur des connexions non sécurisées, ou partagé avec qui que ce soit. Tu peux révoquer l'accès à tout moment depuis les réglages du fournisseur :
- Google : myaccount.google.com → Sécurité → Applis tierces
- Apple : appleid.apple.com → Mots de passe spécifiques à l'app → révoque celui de MoveMentors
- Zoom : marketplace.zoom.us → Manage → Added Apps → révoque MoveMentors
Ce qui se synchronise et quand
- Une réservation est confirmée → lien Meet ou Zoom généré, événement ajouté au calendrier (pour les cours en ligne sur Google), e-mail de confirmation envoyé
- Une réservation est annulée → événement retiré du calendrier (Google uniquement ; Apple est lecture seule de notre côté)
- L'horaire d'un cours change → l'événement bouge dans ton calendrier (Google uniquement)
- Tu te déconnectes → les événements déjà créés restent dans ton calendrier ; on arrête d'en pousser de nouveaux ; les identifiants chiffrés sont supprimés
Les mises à jour sont quasi temps réel via des jobs en arrière-plan.
Questions fréquentes
Je peux synchroniser avec Outlook ? Pas encore nativement. Contournement : abonne-toi au flux .ics de ton planning depuis la page Connections (voir "For other calendar apps" en bas). Ça marche dans Outlook, Fastmail, ProtonCalendar ou toute appli qui gère les abonnements webcal.
Mes événements apparaissent dans le mauvais fuseau horaire. Probablement le fuseau de ton compte calendrier diffère de celui du cours. L'événement est stocké dans le fuseau du cours (correct) ; ton calendrier l'affiche converti dans le fuseau de ton compte (correct). Ça paraît "décalé" quand tu voyages. Ajuste le fuseau de ton appli calendrier si tu as déménagé pour de bon.
La synchro ne fonctionne plus / les événements sont obsolètes. Cause la plus fréquente : token expiré ou révoqué. Va sur /mentor/settings/connections ; la ligne du fournisseur concerné affiche "Not connected". Reconnecte.
Mes réservations en présentiel peuvent aussi apparaître dans mon calendrier ? Pour l'instant Google ne pousse que les réservations de cours en ligne dans ton calendrier (pour que le lien Meet vive sur l'événement). Pour les cours en présentiel, abonne-toi au flux .ics de ton planning (page Connections → en bas), qui inclut tout ce que tu enseignes.
La limite de 40 minutes de Zoom me bloque ? Le plan gratuit de Zoom limite les réunions de groupe à 40 minutes. Options : passe à Zoom Pro (environ 15 $/mois) pour lever la limite, ou bascule le cours sur Google Meet (sans limite de temps sur le plan gratuit Google).
Étapes suivantes
- Planning et récurrence : comment caler tes horaires.
- Synchronisation calendrier pour les élèves : l'équivalent côté élèves.