Ir al contenido principal

Integración con Microsoft Teams - Guía de configuración

Conecta tu cuenta de Microsoft Teams a Goodweek para gestionar canales, mensajes, chats, reuniones, equipos y la programación de turnos directamente desde tu espacio de trabajo de IA.

A
Escrito por Antoine Stempien

Conecta tu cuenta de Microsoft Teams a Goodweek para gestionar canales, mensajes, chats, reuniones, equipos y la programación de turnos directamente desde tu espacio de trabajo de IA.

ℹ️ Nota sobre gobernanza

Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Microsoft Teams, garantizando así 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 un usuario pueda ver y conectar la integración de Microsoft Teams, 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 de Microsoft Teams 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.

Hay tres escenarios típicos según la configuración de tu Entra ID:

  1. El consentimiento del administrador ya se ha otorgado. 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 a Microsoft Entra admin center → Enterprise Applications → Composio → Permissions → Grant admin consent for [tu organización].

  3. El acceso a los datos de Teams o de mensajería está restringido a nivel de recurso. Según las políticas de Teams de tu organización, es posible que se deban configurar permisos adicionales antes de que la integración pueda acceder al contenido de canales o chats.

⚠️ Importante: caso especial de sesión de administrador de Microsoft

Si un administrador del inquilino de Microsoft Entra completa el flujo de conexión OAuth él mismo, Microsoft puede aplicar el consentimiento de administrador automáticamente y vincular 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 (Enterprise Applications → Composio → Permissions → Grant admin consent for your organization) 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 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

  1. En Goodweek, ve a Integraciones.

  2. Busca Microsoft Teams 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 acceso y volver a Goodweek.

Notas importantes

  • Cada usuario debe conectar su propia cuenta individualmente.

  • Goodweek solo puede acceder a los equipos, canales y chats que tu cuenta individual tenga permiso de ver. Los canales privados y el contenido restringido siguen los controles de acceso de Teams.

  • Puedes revocar el acceso de Goodweek en cualquier momento desde Microsoft account → My Account → Privacy → Apps and services → Composio → Remove access.


Herramientas disponibles

Herramienta

Descripción

Tipo

List Teams

Recupera los equipos de Microsoft Teams accesibles para el usuario autenticado, con filtrado opcional.

Lectura

Get Team

Recupera los detalles completos de un equipo específico por su ID.

Lectura

Create Team

Crea un nuevo equipo de Microsoft Teams con plantilla, canales y miembros opcionales.

Escritura

Update Team

Actualiza la configuración del equipo, como los permisos de miembros, mensajería, funciones lúdicas e invitados.

Escritura

Archive Teams Team

Archiva un equipo de Microsoft Teams para eliminarlo de la vista activa mientras conserva sus datos.

Escritura

Unarchive Teams Team

Restaura un equipo archivado de Microsoft Teams a su estado activo.

Escritura

Clone Team

Crea una copia de un equipo de Microsoft Teams existente.

Lectura

List Team Channels

Recupera los canales de un equipo específico de Microsoft Teams, con filtrado opcional.

Lectura

Get Team Channel

Recupera los detalles de un canal específico dentro de un equipo.

Lectura

Create a Channel

Crea un nuevo canal estándar, privado o compartido dentro de un equipo de Microsoft Teams.

Escritura

Update Teams Channel

Actualiza las propiedades del canal, como el nombre visible y la descripción.

Escritura

Archive Channel

Archiva un canal dentro de un equipo de Microsoft Teams.

Escritura

Unarchive Channel

Restaura un canal archivado a su estado activo.

Escritura

List Channel Messages

Enumera los mensajes de un canal de Teams cuando se conocen el ID del equipo y el ID del canal.

Lectura

Get Teams Channel Message

Recupera un mensaje específico de un canal de Microsoft Teams mediante los ID de equipo, canal y mensaje.

Lectura

Send Channel Message

Publica un nuevo mensaje de nivel superior en un canal de Microsoft Teams.

Escritura

Reply to Teams Channel Message

Envía una respuesta a un mensaje existente dentro de un canal específico.

Escritura

List Channel Message Replies

Enumera todas las respuestas a un mensaje específico en un canal de Teams.

Lectura

Search Teams Messages

Busca mensajes de Microsoft Teams mediante la sintaxis KQL, incluidos filtros de remitente, fecha y archivos adjuntos.

Lectura

Get All Chats

Enumera los chats de Microsoft Teams de un usuario específico, con filtrado opcional.

Lectura

Get Chat

Recupera los detalles de un chat específico por su ID.

Lectura

Create Chat

Crea un nuevo chat. Si ya existe un chat individual con los miembros especificados, devuelve sus detalles.

Escritura

Send Message to Teams Chat

Envía un mensaje (texto o HTML) a un chat existente de Microsoft Teams.

Escritura

List User Chat Messages

Recupera los mensajes de un chat específico para un usuario determinado.

Lectura

List Pinned Messages

Recupera la lista de mensajes fijados en un chat de Microsoft Teams.

Lectura

Pin Message in Chat

Fija un mensaje en un chat de Microsoft Teams para consulta rápida.

Lectura

List Team Members

Enumera los miembros de un equipo específico de Microsoft Teams.

Lectura

Get Team Member

Recupera los detalles de un miembro específico del equipo mediante su ID de membresía.

Lectura

Add Member to Team

Añade un usuario a un equipo de Microsoft Teams.

Escritura

Add Team Members (Bulk)

Añade varios miembros a un equipo de Microsoft Teams en una sola operación.

Escritura

Update Team Member

Actualiza el rol o las propiedades de un miembro del equipo dentro del equipo.

Escritura

Add Member to Channel

Añade un usuario a un canal de Microsoft Teams.

Escritura

List Users

Enumera todos los usuarios de la organización a través de Microsoft Graph, con filtrado opcional.

Lectura

List User Joined Teams

Enumera los equipos de Teams de los que un usuario específico es miembro directo.

Lectura

Get User Profile

Recupera el perfil de un usuario, incluidos ID, UPN, correo electrónico y nombre visible.

Lectura

Get User Presence

Recupera la información de presencia actual de un usuario, incluidos disponibilidad y estado de actividad.

Lectura

Create Online Meeting

Programa una nueva reunión en línea independiente de Microsoft Teams no vinculada a un evento de calendario.

Escritura

Get Online Meeting

Recupera los detalles de una reunión en línea específica de Microsoft Teams por su ID.

Lectura

Update Online Meeting

Actualiza las propiedades de una reunión en línea existente de Microsoft Teams.

Escritura

List Meeting Transcripts

Enumera todas las transcripciones asociadas a una reunión en línea específica de Microsoft Teams.

Lectura

Get Meeting Transcript Content

Recupera el contenido de texto sin formato de una transcripción de reunión de Microsoft Teams.

Lectura

List Meeting Recordings

Enumera las grabaciones de una reunión en línea programada y no caducada de Microsoft Teams.

Lectura

Get Meeting Recording Content

Recupera hasta 256 MiB de contenido de video de una grabación de reunión de Teams.

Lectura

Search Teams Files

Busca archivos en Microsoft Teams mediante la sintaxis KQL por nombre, tipo, contenido o autor.

Lectura

Get Channel Files Folder

Recupera los metadatos de la carpeta de archivos de un canal específico en un equipo de Teams.

Lectura

List Shifts

Enumera todos los turnos del calendario de un equipo, con filtrado opcional por fecha.

Lectura

Create Team Schedule Shift

Crea un nuevo turno de trabajo en el calendario de un equipo de Microsoft Teams.

Escritura

Create Time Off

Crea una nueva entrada de tiempo libre aprobada en el calendario de un equipo.

Escritura

Create Time Off Request

Crea una nueva solicitud de tiempo libre en el calendario de un equipo para un miembro del equipo.

Escritura

List Time Off Requests

Enumera todas las solicitudes de tiempo libre del calendario de un equipo de Microsoft Teams.

Lectura

Add Tab to Channel

Añade una nueva pestaña (app o sitio web) a un canal de Microsoft Teams.

Escritura

List Channel Tabs

Enumera todas las pestañas configuradas en un canal de Microsoft Teams.

Lectura

Delete Teams Team

Elimina permanentemente un equipo de Microsoft Teams.

⚠️ Destructivo

Delete Team Channel

Elimina permanentemente un canal de un equipo de Microsoft Teams.

⚠️ Destructivo

Soft-delete Teams Channel Message

Elimina de forma reversible un mensaje en un canal de Teams sin eliminarlo permanentemente.

⚠️ Destructivo

Remove Team Member

Elimina a un usuario de un equipo de Microsoft Teams.

⚠️ Destructivo

Remove Chat Member

Elimina a un miembro de una conversación de chat de Microsoft Teams.

⚠️ Destructivo

Delete User Online Meeting

Elimina permanentemente una reunión en línea de la cuenta de un usuario.

⚠️ Destructivo

Casos de uso

  • Envía mensajes y gestiona conversaciones de canales. Publica mensajes en canales de Teams o envía mensajes en chats directamente desde las conversaciones de Goodweek, manteniendo la comunicación en contexto con el resto del trabajo sin cambiar a Teams.

  • Recupera transcripciones y grabaciones de reuniones. Accede al contenido de la transcripción o grabación de una reunión pasada de Teams desde Goodweek para extraer elementos de acción, resumir discusiones o hacer referencia a decisiones específicas.

  • Gestiona la membresía del equipo y los canales. Añade o elimina miembros del equipo, crea nuevos canales y actualiza las propiedades de los canales desde Goodweek para mantener las estructuras del equipo organizadas sin navegar por la interfaz de administración de Teams.

  • Programa reuniones y gestiona la planificación de turnos. Crea reuniones en línea, gestiona los calendarios del equipo y tramita las solicitudes de tiempo libre desde Goodweek para coordinar el trabajo del equipo de manera eficiente.


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. Pide a tu administrador que siga los pasos de Configuración del administrador anteriores antes de intentar reconectarte.

La integración está conectada pero los canales privados no son visibles

Los canales privados de Microsoft Teams solo son accesibles para sus miembros. Si no eres miembro de un canal privado, no aparecerá a través de la integración. Pide al propietario del canal que te añada.

La integración no es visible en Goodweek

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

Referencias

¿Ha quedado contestada tu pregunta?