POST /v1/calendar/connect/{provider}
Retourne une URL de redirection OAuth one-time. provider ∈ {google, microsoft}. State porte votre customer_user_id round-trip.
04 · calendar integration api
V1 livre M2 2026Calendrier dedans, bots dehors.
Connectez le compte Google Calendar ou Outlook de vos utilisateurs une fois. Nous syncons les événements, évaluons les règles que vous avez définies, et dispatchons un bot d'enregistrement à la bonne minute. Gratuit — vous ne payez que les $0,30/h d'enregistrement que vous consommez réellement.
aperçu
Pourquoi ça existe.
Pourquoi ça existe. Le plus grand fossé de Recall est qu'ils détiennent les tokens OAuth des utilisateurs finaux de leurs clients pour eux, donc le client n'a jamais à construire OAuth deux fois. Nous répliquons ça en M2 : POST /api/v1/calendar/connect/google et /connect/microsoft retournent une URL de redirection que votre utilisateur clique ; au succès nous renvoyons un meetbot_calendar_user_id opaque que vous stockez de votre côté. Nous gardons leur token de rafraîchissement, chiffré au repos avec une clé dérivée KMS par tenant.
À partir de là : un job en arrière-plan poll l'API Google Calendar Events et MS Graph /me/events toutes les cinq minutes par utilisateur connecté, dédoublonne par iCalUid, et évalue vos règles d'enregistrement. Les règles sont en JSON : « enregistre toutes les réunions internes », « saute les 1:1 avec mon manager », « enregistre toujours les réunions avec les domaines @customer.com ». Quand une règle matche, nous planifions le bot pour l'heure de connexion moins 90 secondes. Vous recevez le même webhook signé à la fin que si vous aviez dispatché le bot vous-même.
Multi-tenant by design. Votre id de tenant, l'id de votre utilisateur final, vos règles, votre politique de rétention — tout isolé, tout visible dans l'admin meetbot sous votre compte. Hébergé en UE par défaut avec des SCCs dans le DPA ; région US disponible sur demande. Nous demandons la vérification Google Workspace Marketplace pour que vos utilisateurs finaux voient le nom de votre app dans l'écran de consentement, pas le nôtre.
surface prévue
Spec, à découvert.
GET /v1/calendar/users/{id}/events
Événements syncés pour un de vos utilisateurs finaux. Paginé, watermark-able, inclut l'extraction d'URL de réunion (Meet/Teams/Zoom).
PUT /v1/calendar/users/{id}/rules
Définit les règles d'enregistrement pour un utilisateur. Prédicat JSON sur les métadonnées d'événement : domaine, nombre d'attendees, organisateur, regex de titre.
Job de sync en arrière-plan
Toutes les 5 minutes par utilisateur connecté. Dédoublonne par iCalUid. Les édits/annulations propagent aux dispatches de bot planifiés.
Chiffrement au repos
Tokens de rafraîchissement chiffrés avec des clés dérivées KMS par tenant. Nos DBAs ne peuvent pas lire vos tokens ; seul le principal KMS de runtime de l'orchestrateur peut.
Listings marketplace
Listings vérifiés Google Workspace Marketplace + Microsoft AppSource (en cours) pour que vos utilisateurs voient le nom de votre app sur l'écran de consentement OAuth.