Configuración de Microsoft Teams

¿Nuevo en configuración de canales? Para un tutorial práctico paso a paso, consulta nuestro ''Tutorial de Configuración de Canales''. Esta página es una referencia completa que cubre todas las características y opciones de configuración de Microsoft Teams.

Microsoft Teams es una plataforma de colaboración para empresas. OpenClaw se integra con Teams usando Microsoft Bot Framework, proporcionando chat, canales y características de nivel empresarial.

Configurar Microsoft Teams requiere crear un bot en Azure Portal:

• Crear una app Teams en Azure Portal
• Configurar Bot Framework
• Obtener credenciales del bot
• Configurar en OpenClaw
• Desplegar en Teams

Paso 1: Configuración de Azure Portal

• Ir a Azure Portal
• Crear un nuevo recurso "Azure Bot"
• Elegir "Multi Tenant" o "Single Tenant" según tus necesidades
• Configurar Microsoft App ID y contraseña
• Establecer endpoint de mensajería (tu URL de OpenClaw Gateway)

Paso 2: Configuración de Bot Framework

• En el recurso Azure Bot, ir a "Channels"
• Agregar canal Microsoft Teams
• Configurar ajustes específicos de Teams
• Copiar el Microsoft App ID y contraseña

Paso 3: Manifiesto de App Teams

Crear un manifiesto de app Teams con los detalles de tu bot. Este manifiesto define las capacidades y apariencia de tu bot en Teams.

Configurar Microsoft Teams en tu archivo de configuración OpenClaw:

Configuración de Microsoft Teams

{
  "msteams": {
    "appId": "tu-microsoft-app-id",
    "appPassword": "tu-microsoft-app-password",
    "allowFrom": ["[email protected]", "[email protected]"]
  }
}

Variables de Entorno

También puedes usar variables de entorno:

export MSTEAMS_APP_ID="tu-microsoft-app-id"
export MSTEAMS_APP_PASSWORD="tu-microsoft-app-password"

Lista Permitida de Usuarios

Controlar quién puede interactuar con tu bot:

{
  "msteams": {
    "appId": "tu-microsoft-app-id",
    "appPassword": "tu-microsoft-app-password",
    "allowFrom": [
      "[email protected]",
      "[email protected]"
    ]
  }
}

Control de Acceso de Grupo

Configurar acceso de chat de grupo:

{
  "msteams": {
    "appId": "tu-microsoft-app-id",
    "appPassword": "tu-microsoft-app-password",
    "groupAllowFrom": ["[email protected]"],
    "groupPolicy": "open"
  }
}

Políticas de Grupo:

• "open" - El bot responde a todos los mensajes de grupo
• "allowlist" - Solo responder en grupos listados en groupAllowFrom

OpenClaw soporta varias características de Teams:

• Chats 1-a-1 - Conversaciones directas con usuarios
• Canales de Equipo - Participar en canales de equipo
• Chats de Grupo - Conversaciones multi-usuario
• Menciones - Responder cuando se menciona en canales
• Compartir Archivos - Enviar y recibir archivos
• Tarjetas Ricas - Tarjetas de mensaje interactivas

Desplegar en Teams

• Empaquetar tu manifiesto de app Teams
• Subir a Teams (vía App Studio o directamente)
• Instalar en tu organización o equipos específicos
• Probar funcionalidad del bot

Endpoint de Mensajería

Tu OpenClaw Gateway debe ser accesible desde internet para que Teams envíe mensajes. Configurar:

• URL pública para tu Gateway
• Endpoint HTTPS (requerido por Teams)
• Certificado SSL válido

• 1
  Credenciales SegurasNunca compartas tu App ID y contraseña.
• 2
  Usar Listas PermitidasSiempre configura allowFrom para controlar el acceso.
• 3
  HTTPS RequeridoTeams requiere HTTPS para endpoints de mensajería.
• 4
  Actualizaciones RegularesMantén tu app Teams y OpenClaw actualizados.
• 5
  Logs de AuditoríaMonitorea interacciones del bot para seguridad.

Bot No Responde

Si el bot no responde:

• Verificar que App ID y contraseña sean correctos
• Verificar que el endpoint de mensajería sea accesible
• Asegurar que HTTPS esté correctamente configurado
• Verificar que Gateway esté ejecutándose y recibiendo solicitudes
• Revisar logs de Azure Bot

Problemas de Autenticación

Si la autenticación falla:

• Verificar que App ID coincida con el recurso Azure Bot
• Verificar que App Password sea correcto
• Asegurar que el bot esté registrado en Teams
• Verificar configuración OAuth si usa SSO

Problemas de Acceso de Grupo

Si las características de grupo no funcionan:

• Verificar configuración de groupPolicy
• Verificar que groupAllowFrom incluya IDs de equipo correctos
• Asegurar que el bot esté agregado al equipo/canal
• Verificar permisos del bot en Teams