API de OneDrive: archivos, carpetas y uso compartido con agentes de IA
El acceso a OneDrive por API se hace mediante Microsoft Graph, que permite listar, leer, subir, buscar y compartir archivos de OneDrive y SharePoint. Lo usan las empresas con Microsoft 365 que quieren automatizar documentos. El acceso es con una app registrada en Microsoft Entra ID y con el consentimiento del administrador.
Qué ofrece la API de OneDrive
Archivos y carpetas
Listar, leer, mover, renombrar y eliminar elementos.
Subida y descarga
Subir y descargar archivos, también grandes, por partes.
Búsqueda
Buscar archivos por nombre y por contenido.
Uso compartido
Crear enlaces y definir permisos de acceso.
Cambios
Seguir lo que ha cambiado en una carpeta desde la última consulta.
SharePoint
Acceder con la misma lógica a las bibliotecas de documentos de los sitios.
Cómo acceder a la API de OneDrive
- Con las credenciales de tu empresaOAuth 2.0 con una app registrada en Microsoft Entra ID y permisos de Graph para archivos; los permisos de aplicación requieren el consentimiento del administrador.
- Los permisos de aplicación dan acceso amplio: redúcelos al mínimo.
- Microsoft Graph tiene límites de solicitudes.
- Cuidado con los enlaces de uso compartido externo.
Documentación oficial: learn.microsoft.com/onedrive/developer
Qué hace un agente de iTeam con la API de OneDrive
Orden de los documentos recibidos
El agente guarda los adjuntos del correo en la carpeta correcta del cliente, con un nombre estandarizado.
Búsqueda para el equipo
El empleado pregunta en Teams y el agente encuentra el contrato o la propuesta adecuados.
Revisión de enlaces compartidos
El agente lista los enlaces públicos antiguos y pide aprobación para revocarlos.
Montaje de expedientes
El agente reúne en una carpeta los documentos de un proceso y los comparte con el auditor tras la aprobación.
De la credencial al agente trabajando, con aprobación
Registrar la app en Entra ID
Crea el registro y concede solo los permisos de archivos necesarios, preferiblemente limitados a sitios y carpetas concretos.
Bóveda de iTeam
Guarda el secreto o el certificado en la bóveda y define por agente las carpetas y las acciones permitidas.
Aprobación para compartir
Los enlaces externos y las eliminaciones requieren aprobación humana, con auditoría.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de OneDrive
¿La API de OneDrive es gratuita?
En general, Microsoft Graph no cobra por las llamadas habituales de archivos; el almacenamiento depende de la licencia de Microsoft 365.
¿Necesito programar para usar la API de OneDrive con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación de la API y aprende los endpoints, y el equipo de implantación configura contigo las credenciales, los permisos y las pruebas.
¿La API de OneDrive es Microsoft Graph?
Sí. El acceso actual a OneDrive y SharePoint por API se hace mediante Microsoft Graph.
