POST /v1/calendar/connect/{provider}
Devuelve una URL de redirección OAuth de un solo uso. provider ∈ {google, microsoft}. El estado lleva tu customer_user_id ida y vuelta.
04 · calendar integration api
V1 llega M2 2026Calendario entra, bots salen.
Conecta la cuenta de Google Calendar u Outlook de tus usuarios una vez. Sincronizamos eventos, evaluamos las reglas que definiste, y despachamos un bot de grabación en el minuto correcto. Gratis — solo pagas los $0,30/h de grabación que realmente consumes.
resumen
Por qué existe esto.
Por qué existe esto. El mayor foso de Recall es que custodian los tokens OAuth de los usuarios finales de sus clientes, así el cliente nunca tiene que construir OAuth dos veces. Lo replicamos en M2: POST /api/v1/calendar/connect/google y /connect/microsoft devuelven una URL de redirección que tu usuario clica; al éxito devolvemos un meetbot_calendar_user_id opaco que almacenas en tu lado. Conservamos su token de refresco, cifrado en reposo con una clave derivada de KMS por tenant.
Desde ahí: un trabajo en segundo plano sondea la API de Eventos de Google Calendar y MS Graph /me/events cada cinco minutos por usuario conectado, dedupea por iCalUid, y evalúa tus reglas de grabación. Las reglas son JSON: «graba todas las reuniones internas», «salta los 1:1s con mi manager», «siempre graba reuniones con dominios @customer.com». Cuando una regla coincide, programamos el bot para tiempo-de-unión menos 90 segundos. Recibes el mismo webhook firmado al completar como si hubieras despachado el bot tú mismo.
Multitenant por diseño. Tu id de tenant, el id de tu usuario final, tus reglas, tu política de retención — todo aislado, todo visible en el admin de meetbot bajo tu cuenta. Alojado en la UE por defecto con SCCs en el DPA; región US disponible bajo petición. Estamos solicitando verificación de Google Workspace Marketplace para que tus usuarios finales vean el nombre de tu app en la pantalla de consentimiento, no el nuestro.
superficie planificada
Spec, al descubierto.
GET /v1/calendar/users/{id}/events
Eventos sincronizados para uno de tus usuarios finales. Paginado, watermark-able, incluye extracción de URL de reunión (Meet/Teams/Zoom).
PUT /v1/calendar/users/{id}/rules
Define las reglas de grabación para un usuario. Predicado JSON sobre metadatos de evento: dominio, conteo de asistentes, organizador, regex de título.
Trabajo de sincronización en segundo plano
Cada 5 minutos por usuario conectado. Dedupea por iCalUid. Las ediciones/cancelaciones se propagan a despachos de bot programados.
Cifrado en reposo
Tokens de refresco cifrados con claves derivadas de KMS por tenant. Nuestros DBAs no pueden leer tus tokens; solo el principal KMS de runtime del orquestador puede.
Listados en marketplace
Listados verificados en Google Workspace Marketplace + Microsoft AppSource (en progreso) para que tus usuarios vean el nombre de tu app en la pantalla de consentimiento OAuth.