Microsoft Teams

Menciona a @Devin en Microsoft Teams en cuanto surjan errores, solicitudes de nuevas funciones o preguntas. Devin responde en el hilo con actualizaciones y consultas cuando se le menciona.

1. Ve a Settings > Connections y selecciona Microsoft Teams
2. Haz clic en “Connect”
3. Se te pedirá que instales la aplicación de Devin para Microsoft Teams en tu tenant y/o en el equipo de destino
4. Asegúrate de vincular tu propio usuario. Todos los usuarios de tu organización deberán completar este paso para usar Devin
5. Menciona @Devin en un canal o chat de un equipo para iniciar una sesión

Nota: Para que Devin funcione para cada usuario, cada persona debe conectar su propia cuenta en el panel de control de Devin (Settings > Connections). Esto permite que Devin asocie su identidad de Microsoft Teams con su cuenta de Devin.

Una vez que hayas instalado la integración de Microsoft Teams, simplemente invoca a Devin con @Devin en cualquier canal de Teams. Devin responderá en el hilo de tu sesión. Puedes comunicarte con él igual que en la interfaz de chat habitual de Devin. Ten en cuenta que Devin puede cometer errores. Revisa las respuestas cuidadosamente. Si aún no tienes una cuenta de Devin, puedes obtener más información sobre los precios y los planes aquí. Nuestra política de privacidad está disponible aquí. El siguiente diagrama ilustra la arquitectura de autenticación de alto nivel para la integración con Microsoft Teams, y muestra cómo la autenticación fluye desde Teams a través de varias capas hasta crear sesiones de Devin autenticadas. A continuación se muestra un resumen de los permisos de Microsoft Teams y Microsoft Graph que requiere nuestra integración: qué otorga cada uno, por qué los necesitamos y dónde se utilizan.

De un vistazo

• Graph (aplicación, a nivel de inquilino): orquestación del descubrimiento e instalación.
• Bot de Teams RSC (por equipo/chat): acceso limitado a mensajes, miembros y configuraciones solo donde el bot está instalado o presente.

Estos requieren consentimiento de Admin en Microsoft Entra ID. Son solo de aplicación (sin delegación de usuario).

Nota: No utilizamos Graph a nivel de tenant para leer contenido de mensajes. El acceso a mensajes se otorga solo mediante RSC y únicamente donde el bot está instalado/presente.

Se conceden por equipo o chat en el momento de la instalación (no se aplican a todo el inquilino).

Límites de RSC: El acceso se limita al equipo o chat específico donde la aplicación está instalada o participa. Quitar la aplicación de un equipo o chat revoca ese acceso.

El siguiente diagrama ilustra nuestra autenticación solo de aplicación basada en certificados con Microsoft Graph. Usando un certificado de cliente X.509, el servicio obtiene un token de acceso y luego llama a Graph para listar los equipos de Teams (GET /v1.0/teams). Este ejemplo demuestra cómo Devin realiza de forma segura el descubrimiento del tenant sin contexto de usuario.

Nota sobre credenciales: utilizamos un certificado X.509 (client assertion) en lugar de un client secret para la autenticación de servicio a servicio. Esto se aplica a las llamadas a Microsoft Graph, las comunicaciones del bot con el adaptador de Bot Framework y a cualquier llamada de API de solo aplicación (app-only) desde la integración.

El siguiente diagrama muestra el flujo completo de extremo a extremo cuando un usuario le envía un mensaje a Devin en Microsoft Teams, incluida la validación de tokens y el procesamiento del bot.

Nota sobre credenciales: utilizamos un certificado X.509 (client assertion) en lugar de un client secret para la autenticación de servicio a servicio. Esto se aplica a las llamadas a Microsoft Graph, a las comunicaciones del bot con el adaptador de Bot Framework y a cualquier llamada de API de solo aplicación desde la integración.

1. Consentimiento de administrador (a nivel de organización/tenant)
   • Un administrador de Entra ID otorga los permisos de aplicación de Graph indicados arriba.
2. Descubrimiento de la aplicación
   • La integración consulta el catálogo de aplicaciones de Teams para localizar nuestra aplicación y obtener teamsAppId.
3. Instalación dirigida
   • Desde nuestro panel de control, instalamos el bot en un equipo específico.
   • Durante la instalación, los ámbitos de RSC se otorgan solo a ese equipo (o al chat específico cuando se invoca en un chat).
4. Funcionamiento
   • El descubrimiento (organización/equipos/canales/catálogo de aplicaciones) utiliza permisos de aplicación de Graph.
   • La lectura y el envío de mensajes, así como la lectura de miembros y configuración, se basan en RSC dentro de los contextos donde está instalado.

• Solo lectores básicos: User.ReadBasic.All (sin lectura de mensajes a nivel de todo el tenant).
• El contenido de los mensajes se accede exclusivamente mediante RSC y solo donde el bot está instalado o presente.
• No se solicitan permisos de buzón, archivos ni calendario.

• Revocar el consentimiento de administrador: Un administrador del inquilino (tenant) puede quitar los permisos de la aplicación empresarial en Entra ID.
• Desinstalar de Teams: Quita la aplicación de un equipo/chat para revocar RSC para ese recurso.
• Gestión de datos: Al desinstalar, nuestra integración deja de procesar eventos para ese equipo/chat y elimina las suscripciones/vínculos relacionados.