Conecta tu cuenta de OneDrive a Goodweek para gestionar archivos, carpetas, enlaces para compartir, libros de trabajo y contenido de documentos directamente desde tu espacio de trabajo de IA.
ℹ️ Nota sobre gobernanza
Goodweek nunca superará los niveles de acceso concedidos al usuario dentro de OneDrive, lo que garantiza la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de OneDrive, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración administrativa
La integración de OneDrive utiliza OAuth 2.0 de Microsoft a través de Microsoft Entra ID. Para permitir que los usuarios se conecten, un administrador del inquilino de Microsoft Entra debe conceder el consentimiento del administrador para la aplicación. Sin este paso, es posible que los usuarios vean un error de permisos durante el proceso de conexión.
Existen tres escenarios típicos según la configuración de tu Entra ID:
El consentimiento del administrador ya se ha concedido. Los usuarios pueden conectarse directamente sin pasos adicionales.
El consentimiento del usuario está deshabilitado en tu inquilino. Un administrador de Entra debe otorgar el consentimiento en nombre de la organización antes de que los usuarios puedan conectarse. Ve a Centro de administración de Microsoft Entra → Aplicaciones empresariales → Composio → Permisos → Conceder consentimiento del administrador para [tu organización].
El acceso a los datos de OneDrive o SharePoint está restringido a nivel de recurso. Según la configuración de tu organización, es posible que sea necesario configurar permisos adicionales antes de que la integración pueda acceder al contenido de los archivos.
⚠️ Importante: caso especial de sesión de administrador de Microsoft
Si un administrador del inquilino de Microsoft Entra completa el proceso de conexión OAuth por sí mismo, es posible que Microsoft aplique automáticamente el consentimiento del administrador y vincule la integración a la cuenta del administrador en lugar de a su cuenta de usuario individual. Este es un comportamiento de Microsoft y no se puede modificar a nivel de OAuth.
Enfoque recomendado: El administrador debe aprobar previamente la aplicación en Entra ID (Aplicaciones empresariales → Composio → Permisos → Conceder consentimiento del administrador para tu organización) antes de que cualquier usuario, incluido el administrador, pase por el proceso de conexión de Goodweek. Una vez aprobada previamente, cualquier usuario, incluido el administrador, puede completar el proceso y la integración se vinculará a su cuenta individual.
Alternativamente, un usuario que no sea administrador puede completar primero el proceso de conexión para evitar este problema.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca OneDrive y haz clic en Conectar.
Serás redirigido a Microsoft, donde se te pedirá que inicies sesión con tu cuenta de Microsoft y autorices el acceso.
Haz clic en Aceptar para conceder el acceso y volver a Goodweek.
Notas importantes
Cada usuario debe conectar su propia cuenta individualmente.
Goodweek solo puede acceder a los archivos y carpetas que pertenecen a la cuenta que autorizas, además de cualquier archivo compartido contigo.
Puedes revocar el acceso de Goodweek en cualquier momento desde tu cuenta de Microsoft → Mi cuenta → Privacidad → Aplicaciones y servicios → Composio → Quitar acceso.
Herramientas disponibles
Herramienta | Descripción | Tipo |
List OneDrive Items | Recupera archivos y carpetas de la raíz de OneDrive del usuario. | Lectura |
List Folder Children | Enumera los archivos y carpetas directos dentro de una carpeta de OneDrive mediante el ID de DriveItem o la ruta. | Lectura |
List All Drive Items | Enumera de forma segura una unidad completa de OneDrive o SharePoint mediante paginación delta. | Lectura |
Find Item | Encuentra un archivo o carpeta por nombre dentro de una carpeta específica de OneDrive. | Lectura |
Find Folder | Encuentra carpetas por nombre dentro de una carpeta principal accesible en OneDrive. | Lectura |
Search Drive Items | Busca por palabra clave en OneDrive y en los archivos accesibles de SharePoint, incluyendo nombres de archivo, metadatos y contenido. | Lectura |
Search Items | Busca archivos y carpetas en OneDrive por palabra clave, incluyendo el contenido de los archivos. | Lectura |
Get Item Metadata | Recupera los metadatos de un DriveItem mediante su ID único, incluidos el nombre, el tamaño y las marcas de tiempo. | Lectura |
Get Drive Root Folder | Recupera los metadatos de la carpeta raíz del OneDrive del usuario que ha iniciado sesión. | Lectura |
Get Drive Special Folder | Recupera una carpeta especial de OneDrive por nombre (Documentos, Escritorio, Fotos, etc.). | Lectura |
Get DriveItem by Sharing URL | Resuelve una URL para compartir de OneDrive o SharePoint a un DriveItem con metadatos completos. | Lectura |
List OneDrive Shared Items | Enumera los archivos compartidos desde las cuentas de OneDrive de otras personas que son accesibles para el usuario. | Lectura |
Download a File | Descarga un archivo de OneDrive mediante su ID de elemento. | Lectura |
Download File by Path | Descarga el contenido de un archivo de OneDrive mediante su ruta. | Lectura |
Download Item as Format | Descarga un DriveItem convertido a un formato específico, como PDF o HTML. | Lectura |
Upload File | Sube un archivo a una carpeta específica de OneDrive, creando la carpeta de destino si es necesario. | Escritura |
Update File Content | Actualiza el contenido de un archivo existente en OneDrive. | Escritura |
Create Folder | Crea una nueva carpeta en el OneDrive del usuario con un comportamiento de conflicto configurable. | Escritura |
Create a New Text File | Crea un nuevo archivo de texto sin formato con el contenido especificado en OneDrive. | Escritura |
Move Item | Mueve un archivo o carpeta a una nueva carpeta principal en OneDrive para su reorganización. | Lectura |
Copy Item | Copia un DriveItem (archivo o carpeta) a una nueva ubicación de forma asíncrona. | Lectura |
Update Drive Item Metadata | Actualiza los metadatos de un elemento de OneDrive, incluidos el nombre, la descripción y la carpeta principal. | Escritura |
Create Sharing Link | Crea un enlace para compartir un DriveItem con un tipo de acceso y permisos configurables. | Escritura |
Invite User to Drive Item | Invita a usuarios y les concede permisos sobre un elemento específico de OneDrive. | Escritura |
Get Item Permissions | Recupera los permisos de un DriveItem dentro de una unidad específica. | Lectura |
Update Drive Item Permissions | Actualiza los roles de un permiso existente en un elemento de OneDrive. | Escritura |
Get Item Versions | Recupera el historial de versiones de un DriveItem mediante su ID único. | Lectura |
Restore Item Version | Restaura una versión anterior de un archivo creando una nueva versión a partir de la versión histórica especificada. | Lectura |
Check Out Drive Item | Registra la salida de un DriveItem para evitar que otros lo editen hasta que se completen los cambios. | Lectura |
Check In Drive Item | Registra la entrada de un DriveItem cuya salida se había registrado, para que la nueva versión sea visible para los demás. | Lectura |
Discard Checkout | Descarta el registro de salida de un DriveItem, liberándolo y descartando los cambios realizados. | Lectura |
List Drive Activities | Recupera las actividades recientes en el OneDrive del usuario autenticado. | Lectura |
List Root Drive Changes | Enumera los cambios en la raíz de la unidad principal del usuario mediante un token delta para la sincronización incremental. | Lectura |
Preview Drive Item | Genera una URL de vista previa incrustable de corta duración para un DriveItem específico. | Lectura |
Get Document Comments | Extrae los comentarios de un archivo Word .docx almacenado en OneDrive. | Lectura |
List Drives | Enumera todos los recursos de tipo Drive disponibles para el usuario autenticado, incluidas las unidades personales y compartidas. | Lectura |
Get SharePoint List Items (via OneDrive) | Recupera elementos de una lista de SharePoint a través de la conexión de OneDrive. | Lectura |
List Site Lists | Enumera todas las listas de un sitio de SharePoint específico a través de la conexión de OneDrive. | Lectura |
List Site Subsites | Enumera todos los subsitios de un sitio de SharePoint a través de la conexión de OneDrive. | Lectura |
Get Workbook Used Range | Recupera la región de datos activa de una hoja de cálculo en un libro de Excel almacenado en OneDrive. | Lectura |
Read Workbook Range | Lee un intervalo específico de celdas de una hoja de un libro de Excel almacenado en OneDrive. | Lectura |
Update Workbook Range | Actualiza un intervalo en una hoja de un libro de Excel almacenado en OneDrive. | Escritura |
Write Workbook Cell | Actualiza el valor, la fórmula o el formato de una celda específica en un libro de Excel almacenado en OneDrive. | Escritura |
Restore Deleted Item | Restaura un DriveItem eliminado (archivo o carpeta) desde la papelera de reciclaje. | Lectura |
Delete Item | Elimina un DriveItem (archivo o carpeta) mediante su ID único, moviéndolo a la papelera de reciclaje. | ⚠️ Destructivo |
Permanently Delete Drive Item | Elimina permanentemente un DriveItem sin moverlo a la papelera de reciclaje. Esta acción es irreversible. | ⚠️ Destructivo |
Delete Drive Item Permission | Revoca un permiso para compartir de un elemento de OneDrive. | ⚠️ Destructivo |
Casos de uso
Encuentra y recupera archivos según sea necesario. Busca en OneDrive por palabra clave en nombres de archivo y contenido desde Goodweek para localizar documentos específicos sin explorar la estructura de carpetas manualmente.
Sube y organiza archivos. Sube archivos nuevos a carpetas de OneDrive, crea estructuras de carpetas y mueve o copia archivos existentes desde conversaciones de Goodweek para mantener los documentos organizados.
Comparte archivos con el nivel de acceso adecuado. Genera enlaces para compartir o invita a usuarios específicos a un archivo o carpeta desde Goodweek, con permisos de visualización o edición configurables, al compartir contenido con colegas o terceros.
Lee y actualiza libros de Excel. Recupera datos de intervalos de celdas específicos en libros de Excel almacenados en OneDrive y actualiza valores de celdas o intervalos desde Goodweek sin abrir el archivo directamente.
Solución de problemas
Error de permisos durante la conexión
Es posible que el administrador de tu inquilino de Microsoft Entra deba conceder el consentimiento para la aplicación. Pídele a tu administrador que siga los pasos de Configuración administrativa mencionados anteriormente antes de intentar volver a conectarse.
La integración no es visible en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de OneDrive desde el Panel de administración de Goodweek, en la pestaña Integraciones.