Conectores Microsoft Graph y Google Workspace para correo y directorio
Conectores de solo lectura para el directorio y los metadatos de correo de Microsoft 365 y Google Workspace, con sincronización incremental que se retoma donde se quedó, reintentos y credenciales guardadas cifradas.
Integrar con Microsoft 365 y Google Workspace parece sencillo hasta que aparecen los límites de uso, la paginación, los accesos que caducan y los correos repetidos en varios buzones. Estos conectores Microsoft Graph y Google Workspace leen el directorio y los metadatos de correo de una organización de forma incremental, y retoman la lectura donde se quedó si se corta, para que los incorpores a tu producto.
Para quién es
Equipos de desarrollo que necesitan leer usuarios, grupos y actividad de correo de sus clientes sin construir y mantener la integración desde cero.
Qué resuelven los conectores Microsoft Graph y Google Workspace
- Sincronizaciones que se cortan. El punto de avance se guarda tras cada página, así que un trabajo interrumpido continúa donde lo dejó.
- Duplicados. El mismo mensaje visto en varios buzones, o en los dos proveedores, se registra una sola vez.
- Seguridad de la integración. Solo se siguen enlaces de las direcciones oficiales de Microsoft y Google, y las credenciales se guardan cifradas.
Qué hace
Microsoft 365
- Gestiona el consentimiento de administrador en dos pasos y comprueba que quien autoriza lo es.
- Funciona con la aplicación de cada cliente o con una común para varios.
- Lee del directorio usuarios, grupos, alias y buzones compartidos, solo con los cambios desde la última lectura.
- Lee los metadatos del correo enviado y recibido y, si se configura, el asunto. Si Microsoft limita la carga inicial, queda declarado qué periodo se ha cubierto.
- Comprueba qué permisos se han concedido.
Google Workspace
- Se conecta con una cuenta de servicio autorizada por el administrador del dominio.
- Lee el directorio y los metadatos de Gmail, con una carga inicial acotada y después solo los cambios. Si el historial de cambios caduca, se recupera solo.
- Lee los alias de envío.
En los dos
- Reintenta cuando el proveedor limita las peticiones, respetando la espera que indica, y renueva el acceso cuando caduca.
- Guarda las credenciales cifradas, con cambio periódico de claves.
Beneficios
- Ahorras a tu equipo una integración delicada, llena de casos raros.
- Lees lo mínimo necesario: directorio y metadatos, sin cuerpo ni adjuntos.
- Una caída a mitad de sincronización no obliga a empezar de nuevo.
Contexto del sector
Datos generales del sector con su fuente pública. No son resultados de este producto.
- En 2025, el 52,74 % de las empresas de la UE usaba servicios de computación en la nube de pago y, de ellas, el 85,15 % tenía el correo electrónico en la nube. Fuente: Eurostat, «Cloud computing - statistics on the use by enterprises», 2025.
Qué recibes según la modalidad
Precio a consultar según modalidad y alcance. El soporte para integrarlo y el mantenimiento se contratan aparte.
- El código del módulo, para incorporarlo a tu aplicación.
- Ejemplos de integración y documentación.
- Garantía frente a defectos durante el periodo pactado.
- Todo lo anterior, con derecho a adaptarlo y mantenerlo dentro de tu producto.
- Derecho a integrar el activo en un producto comercial propio, identificado en el contrato.
- Derecho a distribuirlo como parte de ese producto a tus clientes, sin pedir autorización por cada instalación y sin límite de clientes finales, salvo pacto.
- No incluye revenderlo ni sublicenciarlo por separado.
- No es exclusiva, salvo pacto.
- El mantenimiento, el soporte y las adaptaciones se contratan aparte.
Ficha técnica
Lenguaje y entorno de ejecución: TypeScript 5.9 sobre Node.js. Versión mínima compatible: Node.js 20.19 (la que exige Prisma 7).
Frameworks: Prisma 7.10 para la persistencia y Zod 4.6. No usa los SDK de Microsoft ni de Google: las llamadas a sus API se hacen directamente.
Base de datos: PostgreSQL.
Sistemas operativos: Servidor con Node.js.
Idiomas de la interfaz: No tiene interfaz de usuario propia.
Infraestructura necesaria:
- PostgreSQL.
- Un sistema de trabajos en segundo plano para lanzar las sincronizaciones.
- Claves de cifrado propias para guardar las credenciales.
- Para Microsoft 365, una aplicación registrada en Microsoft Entra ID (requiere cuenta propia del comprador).
- Para Google Workspace, un proyecto de Google Cloud con una cuenta de servicio y delegación de dominio (requiere cuenta propia del comprador).
Despliegue privado: El módulo se ejecuta en tu infraestructura, pero necesita conexión con Microsoft Graph y con las API de Google, que son la fuente de los datos.
Bibliotecas principales:
| Biblioteca | Versión | Licencia |
|---|---|---|
| @prisma/client | 7.10.0 | Apache-2.0 |
| @prisma/adapter-pg | 7.10.0 | Apache-2.0 |
| pg | 8.23.1 | MIT |
| zod | 4.6.7 | MIT |
Dependencias con condiciones de licencia específicas: Ninguna dependencia del módulo tiene licencia copyleft ni condiciones comerciales específicas.
Compatibilidades e integraciones: Microsoft Graph API v1.0 y plataforma de identidad de Microsoft (OAuth 2.0, endpoints v2.0, con consentimiento de administrador); Admin SDK Directory API v1 y Gmail API v1 de Google Workspace, con cuenta de servicio y delegación de dominio.
Condiciones de redistribución
El código propio admite integración en productos comerciales del licenciatario en las modalidades de módulo integrable, licencia de código y licencia OEM, en los términos del contrato. Ninguna dependencia de producción del módulo tiene licencia copyleft ni condiciones comerciales específicas.
Requisitos de instalación
Una aplicación de servidor Node.js con base de datos PostgreSQL y un sistema de trabajos en segundo plano para lanzar las sincronizaciones. En Microsoft 365 hay que registrar una aplicación en Entra ID; en Google Workspace, una cuenta de servicio con delegación de dominio.
Preguntas frecuentes
¿Lee el cuerpo de los correos?
No. Lee las cabeceras y, si se configura, el asunto. El cuerpo y los adjuntos no se descargan.
¿Qué permisos hay que conceder?
Solo de lectura: directorio y metadatos de correo. El módulo comprueba qué se ha concedido.
¿El mantenimiento está incluido?
No. El mantenimiento (actualizaciones y corrección de errores) y el soporte para integrarlo se contratan aparte.
Encajan con este activo
Solicitud
Solicita información sobre M-CON-01
Rellena el formulario con la referencia del activo y la modalidad que te interesa. Te respondo por escrito. Si necesitas revisar el código, marca la casilla del NDA y lo preparamos antes de enseñar nada.