Primeros pasos
Instalación
- Ve a Settings > Integrations y selecciona Microsoft Teams
- Haz clic en “Connect”
- Se te pedirá que instales la aplicación de Devin para Microsoft Teams en tu tenant y/o en el equipo de destino
- Asegúrate de vincular tu propio usuario. Todos los usuarios de tu organización deberán completar este paso para usar Devin
- Menciona
@Devinen 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 > Integrations). Esto permite que Devin asocie su identidad de Microsoft Teams con su cuenta de Devin.
Cómo usar Devin en Microsoft Teams
@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.
Palabras clave y funciones inline de Teams
| Palabra clave | Función |
|---|---|
!ask | Comienza tu mensaje con !ask para obtener rápidamente una respuesta sobre tu base de código sin iniciar un agente completo |
!deep | Obtén una respuesta de análisis más profunda usando una búsqueda avanzada |
mute | Impide que Devin vea más mensajes en el hilo |
unmute | Revierte lo anterior |
(aside), !aside | Hace que Devin ignore el mensaje (útil para comentarios sobre la ejecución de Devin directamente en el hilo) |
sleep | Pone a Devin en reposo; para despertarlo, envía cualquier mensaje en el hilo |
archive | Pone a Devin en reposo y, además, archiva la sesión |
EXIT | Finaliza la sesión |
help | Muestra un mensaje de ayuda con las palabras clave y funciones disponibles |
Precios
Privacidad
Flujo de autenticación
Detalles de permisos
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.
Permisos de Microsoft Graph (aplicación) a nivel de tenant
| Permiso | Qué permite | Por qué lo necesitamos |
|---|---|---|
Organization.Read.All | Leer el perfil básico de la organización | Validar el tenant donde se está instalando la aplicación |
User.ReadBasic.All | Leer perfiles básicos de todos los usuarios | Mapear las identidades de los miembros y resolver menciones en los Teams asociados |
AppCatalog.Read.All | Leer el catálogo de aplicaciones de Teams | Ubicar nuestra aplicación y obtener el teamsAppId requerido para la instalación |
TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All | Instalar/desinstalar nuestra propia aplicación; otorgar RSC a la app | Instalar/eliminar el bot en un equipo seleccionado desde el dashboard de Devin |
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.
Permisos de consentimiento específicos de recursos (RSC) del bot de Teams
| Permiso | Ámbito | Qué permite | Por qué lo necesitamos |
|---|---|---|---|
ChannelMessage.Read.Group | Equipo/Canal | Leer mensajes de canal donde la aplicación está instalada | Procesar conversaciones de canal (resúmenes, disparadores, sincronización) |
ChannelMessage.Send.Group | Equipo/Canal | Enviar mensajes en canales (nuevas publicaciones y respuestas en hilos) donde la aplicación está instalada | Responder a mensajes en hilos de canal y publicar actualizaciones de forma proactiva en los canales |
Member.Read.Group | Equipo/Canal | Leer los miembros del equipo | Relacionar identidades, comprobaciones de permisos, enrutamiento de menciones |
TeamSettings.Read.Group | Equipo/Canal | Leer la configuración del equipo | Respetar las directivas a nivel de equipo y adaptar el comportamiento |
ChatMember.Read.Chat | Chat | Leer los participantes del chat | Dirigirse y responder correctamente y permitir registros de auditoría |
ChatMessage.Read.Chat | Chat | Leer mensajes en chats donde el bot participa | Procesar solicitudes, contexto y seguimientos posteriores |
ChatMessage.Send.Chat | Chat | Enviar mensajes en chats 1:1 y de grupo (mensajes directos, DMs) donde el bot participa; no para canales | Responder a usuarios en mensajes directos y chats de grupo, publicar notificaciones y respuestas interactivas en hilos de chat |
ChatSettings.Read.Chat | Chat | Leer la configuración del chat (por ejemplo, moderación) | Alinear el comportamiento con las directivas del chat (límites de frecuencia, quién puede publicar, etc.) |
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.
Ejemplo: Autenticación basada en certificados para el descubrimiento de Teams
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.
Flujo completo de procesamiento de mensajes (Teams → Cognition)
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.
Flujo de consentimiento e instalación
- Consentimiento de administrador (a nivel de organización/tenant)
- Un administrador de Entra ID otorga los permisos de aplicación de Graph indicados arriba.
- Descubrimiento de la aplicación
- La integración consulta el catálogo de aplicaciones de Teams para localizar nuestra aplicación y obtener
teamsAppId.
- La integración consulta el catálogo de aplicaciones de Teams para localizar nuestra aplicación y obtener
- 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).
- 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.
Notas sobre privilegios mínimos
- 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.
Revocación y desinstalación
- 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.
