Ir al contenido principal

Integración con SharePoint - Guía de configuración

Conecta tu cuenta de SharePoint a Goodweek para gestionar documentos, listas, carpetas, archivos y contenido del sitio directamente desde tu espacio de trabajo de IA.

A
Escrito por Antoine Stempien

Conecta tu cuenta de SharePoint a Goodweek para gestionar documentos, listas, carpetas, archivos y contenido del sitio directamente desde tu espacio de trabajo de IA.

ℹ️ Nota de gobernanza

Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de SharePoint, 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 con SharePoint, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Configuración del administrador

La integración con SharePoint utiliza Microsoft OAuth 2.0 a través de Microsoft Entra ID. Para permitir que los usuarios se conecten, un administrador del inquilino de Microsoft Entra debe otorgar el consentimiento de 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:

  1. Ya se ha otorgado el consentimiento de administrador. Los usuarios pueden conectarse directamente sin pasos adicionales.

  2. 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 al centro de administración de Microsoft Entra → Aplicaciones empresariales → Composio → Permisos → Otorgar consentimiento de administrador para [tu organización].

  3. El acceso a SharePoint está restringido a nivel de recurso. Según la configuración de SharePoint de tu organización, es posible que se deban configurar permisos adicionales a nivel de sitio o de inquilino antes de que la integración pueda acceder al contenido.

⚠️ Importante: caso particular de la sesión de administrador de Microsoft

Si un administrador del inquilino de Microsoft Entra completa el proceso de conexión de OAuth él mismo, es posible que Microsoft aplique el consentimiento de administrador automáticamente 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 cambiar a nivel de OAuth.

Enfoque recomendado: El administrador debe aprobar previamente la aplicación en Entra ID (Aplicaciones empresariales → Composio → Permisos → Otorgar consentimiento de administrador para tu organización) antes de que cualquier usuario, incluido el administrador, realice el proceso de conexión de Goodweek. Una vez aprobada previamente, cualquier usuario, incluido el administrador, puede completar el proceso y la integración quedará vinculada 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

  1. En Goodweek, ve a Integraciones.

  2. Busca SharePoint y haz clic en Conectar.

  3. Serás redirigido a Microsoft, donde se te pedirá que inicies sesión con tu cuenta de Microsoft y autorices el acceso.

  4. Haz clic en Aceptar para otorgar el acceso y volver a Goodweek.

Notas importantes

  • Cada usuario debe conectar su propia cuenta individualmente.

  • Goodweek solo puede acceder a los sitios, listas y documentos que tu cuenta individual tiene permiso para acceder dentro de SharePoint.

  • Puedes revocar el acceso de Goodweek en cualquier momento desde Cuenta de Microsoft → Mi cuenta → Privacidad → Aplicaciones y servicios → Composio → Quitar acceso.


Herramientas disponibles

Herramienta

Descripción

Tipo

List SharePoint Sites

Enumera todos los sitios de SharePoint accesibles para el usuario, con fines de descubrimiento.

Lectura

Get SharePoint Site by Hostname

Obtiene los metadatos del sitio por nombre de host o URL, incluidos el ID del sitio y el nombre para mostrar.

Lectura

Get SharePoint Root Site

Obtiene los metadatos del sitio web raíz de una colección de sitios de SharePoint.

Lectura

Get SharePoint Web Info

Obtiene información sobre el sitio web actual de SharePoint, incluidos el título y la URL.

Lectura

List SharePoint Lists

Enumera todas las listas y bibliotecas de documentos del sitio de SharePoint actual.

Lectura

Get SharePoint List by GUID

Obtiene una lista específica de SharePoint mediante su identificador único.

Lectura

Get SharePoint List by Title

Obtiene una lista de SharePoint mediante su título visible.

Lectura

List SharePoint List Columns

Enumera todas las definiciones de columnas de una lista de SharePoint, incluidos los metadatos de los campos.

Lectura

Create SharePoint List

Crea una nueva lista en SharePoint mediante la API REST.

Escritura

Update SharePoint List

Actualiza propiedades de una lista de SharePoint existente, como el título o la descripción.

Escritura

Get SharePoint List Items

Obtiene elementos de una lista de SharePoint con filtrado OData y paginación opcionales.

Lectura

Get List Item by ID

Obtiene un elemento específico de una lista de SharePoint mediante su ID numérico.

Lectura

Create SharePoint List Item

Crea un nuevo elemento en una lista de SharePoint.

Escritura

Update SharePoint List Item

Actualiza campos de un elemento existente de una lista de SharePoint.

Escritura

List Drive Children

Enumera archivos y carpetas de una biblioteca de documentos o carpeta de SharePoint.

Lectura

List Files in Folder

Enumera los archivos dentro de una carpeta específica de SharePoint (sin recursividad).

Lectura

List Subfolders in Folder

Enumera las subcarpetas directas dentro de una carpeta de SharePoint.

Lectura

Get All SharePoint Folders

Obtiene todas las carpetas del sitio web de SharePoint, con fines de descubrimiento.

Lectura

Create SharePoint Folder

Crea una nueva carpeta en una biblioteca de documentos de SharePoint.

Escritura

Rename SharePoint Folder

Cambia el nombre de una carpeta de SharePoint actualizando los metadatos de su elemento de lista.

Lectura

Upload File to Folder

Sube un archivo a una biblioteca de documentos o carpeta de SharePoint.

Escritura

Upload File from URL to SharePoint

Obtiene un archivo desde una URL y lo sube directamente a SharePoint.

Escritura

Download File by Server-relative URL

Descarga un archivo de SharePoint mediante su URL relativa al servidor.

Lectura

Get Site Drive Item by Path

Obtiene los metadatos de un archivo o carpeta mediante su ruta relativa al servidor.

Lectura

Update Drive Item

Actualiza propiedades de un elemento de unidad (archivo o carpeta) en SharePoint.

Escritura

Update File Item Metadata

Actualiza los campos de metadatos de un elemento de archivo de SharePoint.

Escritura

Search SharePoint Site

Busca contenido de SharePoint mediante Keyword Query Language para documentos, elementos y carpetas.

Lectura

Search Files Across All Sites

Busca archivos en todos los sitios de SharePoint y en OneDrive mediante Keyword Query Language.

Lectura

Check Out SharePoint File

Registra la salida (checkout) de un archivo para bloquearlo antes de realizar cambios.

Lectura

Check In SharePoint File

Registra la entrada (check-in) de un archivo para finalizar los cambios y poner disponible la nueva versión.

Lectura

Recycle SharePoint File

Mueve un archivo a la Papelera de reciclaje de SharePoint (eliminación reversible).

Lectura

Restore Recycle Bin Item

Restaura un elemento eliminado de SharePoint desde la Papelera de reciclaje mediante su GUID.

Lectura

Create Drive Item Sharing Link

Crea un enlace para compartir un elemento de unidad de SharePoint con un tipo de acceso configurable.

Escritura

Add Attachment to List Item

Sube un archivo binario como adjunto a un elemento de una lista de SharePoint.

Escritura

List Item Attachments

Enumera todos los adjuntos de un elemento de una lista de SharePoint.

Lectura

Download List Item Attachment

Descarga el contenido binario de un adjunto de un elemento de una lista de SharePoint.

Lectura

Get Content Types for List

Obtiene todos los tipos de contenido de una lista específica de SharePoint.

Lectura

Create Content Type

Crea un nuevo tipo de contenido en SharePoint con las definiciones de campos especificadas.

Escritura

List Site Groups

Enumera todos los grupos de sitio de SharePoint de una colección de sitios.

Lectura

Get Group Users

Obtiene todos los usuarios que son miembros de un grupo de SharePoint especificado.

Lectura

List Site Users

Enumera los usuarios de la colección de sitios, incluidos usuarios individuales y grupos.

Lectura

Find SharePoint User

Busca un usuario en el sitio de SharePoint por dirección de correo electrónico.

Lectura

Get Drive Item Analytics

Obtiene estadísticas de acceso (número de visualizaciones) de un elemento de unidad de SharePoint.

Lectura

List Recently Modified Drive Items

Enumera los elementos modificados recientemente en una unidad de SharePoint.

Lectura

Restore Drive Item Version

Restaura una versión anterior de un elemento de unidad de SharePoint.

Lectura

Delete SharePoint File

Elimina permanentemente un archivo de una biblioteca de documentos de SharePoint.

⚠️ Destructivo

Delete SharePoint Folder

Elimina permanentemente una carpeta de una biblioteca de documentos de SharePoint.

⚠️ Destructivo

Delete SharePoint List Item

Elimina permanentemente un elemento de una lista de SharePoint mediante su ID.

⚠️ Destructivo

Delete SharePoint List

Elimina permanentemente una lista de SharePoint mediante su GUID.

⚠️ Destructivo

Casos de uso

  • Encuentra y recupera documentos en distintos sitios. Busca en los sitios de SharePoint mediante palabras clave o explora la estructura de carpetas desde Goodweek para localizar archivos específicos y obtener su contenido o enlaces de descarga sin necesidad de navegar por la interfaz de SharePoint.

  • Crea y actualiza elementos de listas. Añade o modifica elementos en las listas de SharePoint desde las conversaciones de Goodweek, útil para actualizar seguimientos de proyectos, registros de incidencias o cualquier dato estructurado almacenado en listas de SharePoint.

  • Sube y organiza archivos. Sube archivos a bibliotecas de documentos, crea carpetas y gestiona la organización de archivos en SharePoint directamente desde Goodweek, manteniendo los documentos actualizados sin necesidad de navegación manual por el navegador.

  • Comparte documentos con niveles de acceso específicos. Genera enlaces para compartir archivos o carpetas con el nivel de permiso adecuado desde Goodweek al compartir recursos con partes interesadas internas o externas.


Solución de problemas

Error de permisos durante la conexión

Es posible que tu administrador del inquilino de Microsoft Entra deba otorgar el consentimiento para la aplicación. Pídele a tu administrador que siga los pasos de Configuración del administrador anteriores antes de intentar volver a conectarte.

La integración está conectada, pero algunos sitios o archivos no son accesibles

SharePoint respeta los permisos a nivel de sitio y de elemento. Si no puedes acceder a un sitio o una biblioteca de documentos específicos, tu administrador de SharePoint deberá concederte acceso directamente dentro de SharePoint.

La integración no aparece en Goodweek

Asegúrate de que el administrador de tu organización haya habilitado la integración con SharePoint desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Referencias

¿Ha quedado contestada tu pregunta?