> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Activa y configura el canal de Microsoft Teams para conectar tu agente de Brain Studio a la plataforma de colaboración de Microsoft.

## Introducción

El canal **Microsoft Teams** conecta tu agente de Brain Studio a Teams para que tus colaboradores y clientes obtengan respuestas rápidas y personalizadas sin salir de la plataforma de colaboración de Microsoft.

La conexión se hace a través de una app de **Azure Bot** que tú registras en Azure. Jelou recibe los mensajes desde Teams, ejecuta el flujo publicado y devuelve las respuestas del agente al mismo chat.

## Requisitos previos

Antes de activar el canal, asegúrate de tener:

* Una cuenta activa en Jelou y acceso a la sección **Canales**
* Un registro de aplicación en **Microsoft Entra ID** (antes Azure AD), con estos tres datos a la mano:
  * **App ID** (client ID)
  * **Contraseña de la app** (client secret)
  * **Tenant ID**
* Un recurso de **Azure Bot** asociado a ese registro, con el canal **Microsoft Teams** habilitado
* Acceso al **Portal de Desarrolladores de Teams** o al **Portal de Azure** para configurar el messaging endpoint del bot

<Note>
  El canal de Microsoft Teams se provisiona únicamente como **single-tenant**. El tipo de app no es seleccionable durante la activación.
</Note>

<Warning>
  Si no ves la opción de Microsoft Teams en la lista de canales, tu plan no la incluye. Contacta con tu administrador o con el equipo de soporte de Jelou.
</Warning>

## Activar el canal

<Steps>
  <Step title="Abrir la sección Canales">
    Inicia sesión en Jelou, ve a **Canales** y selecciona la opción **Microsoft Teams**.
  </Step>

  <Step title="Nombrar el canal y elegir el proyecto">
    Asigna un nombre descriptivo, por ejemplo `Teams - Soporte interno`. El nombre debe tener entre 4 y 50 caracteres.

    Luego selecciona el **proyecto** de Brain Studio al que se conectará el canal.

    <Tip>
      Usa un nombre que identifique el entorno además del canal, por ejemplo `Teams - RRHH Producción`, para distinguirlo con facilidad en el listado.
    </Tip>
  </Step>

  <Step title="Ingresar las credenciales del Azure Bot">
    En el segundo paso del modal completa los tres campos, todos obligatorios:

    * **App ID**: el App ID (client ID) de tu Azure Bot
    * **Contraseña de la app**: el client secret de la app
    * **Tenant ID**: el tenant ID de Azure AD

    Si dejas un campo vacío, el formulario lo marca en rojo con el mensaje *Este valor es obligatorio* y el botón de creación permanece deshabilitado.
  </Step>

  <Step title="Crear y conectar el canal">
    Pulsa **Crear y conectar canal**. Jelou crea el canal y muestra la **URL del messaging endpoint** que necesitas para terminar la conexión del lado de Microsoft.
  </Step>

  <Step title="Configurar el messaging endpoint en Teams">
    Copia la URL y pégala en el campo **messaging endpoint** del bot. Puedes hacerlo desde cualquiera de estos dos lugares:

    * **Portal de Desarrolladores de Teams**: ve a *Tools → Bot management*, selecciona tu bot y completa **Endpoint address**.
    * **Portal de Azure**: abre el recurso **Azure Bot** y ve a *Settings → Configuration → Messaging endpoint*.

    <Note>
      Puedes volver a encontrar esta URL en cualquier momento en las propiedades del canal, así que no es necesario guardarla aparte.
    </Note>
  </Step>

  <Step title="Construir la lógica en Brain Studio">
    Abre el proyecto en Brain Studio, selecciona el canal **Microsoft Teams** en el listado de workflows y comienza a construir tu flujo.
  </Step>
</Steps>

## Contenido soportado

Teams renderiza los mensajes como Adaptive Cards, por lo que el canal admite un subconjunto de los bloques disponibles en WhatsApp:

| Bloque  | Disponible | Límite                         |
| ------- | ---------- | ------------------------------ |
| Texto   | Sí         | 4096 caracteres                |
| Imagen  | Sí         | JPEG y PNG, hasta 5 MB         |
| Botones | Sí         | Máximo 3 por mensaje           |
| Lista   | Sí         | Máximo 10 opciones             |
| CTA URL | Sí         | Se envía como `Action.OpenUrl` |

Otros límites que aplica el canal:

* **Caption de multimedia**: 1024 caracteres
* **Cuerpo de mensajes con botones**: 1024 caracteres
* **Nombre de archivo**: 255 caracteres

## Limitaciones del canal

En el builder, algunos nodos y herramientas no están disponibles en el canal **Microsoft Teams** porque dependen de WhatsApp u otras integraciones.

### Nodos y bloques no disponibles

* Plantilla HSM
* WhatsApp Flows
* Video
* Audio
* Documento y Archivo
* Sticker
* Carrusel
* Lista numerada
* Webview
* Ubicación
* Contacto
* Respuestas rápidas
* Pagos
* Connect (asesor)
* Biometría
* Transferencia a humano (HubSpot, Genesys u otros)

### Herramientas del Agente IA no disponibles

* Call to action (`send_call_to_action`)
* Transferir a asesor (`transfer_to_agent`)
* Jelou Shop

## Próximos pasos

Una vez conectado el canal:

1. Envía un mensaje directo al bot desde Teams para verificar la conexión
2. Revisa los logs de ejecución en Brain Studio para confirmar que el flujo se ejecuta
3. Ajusta el flujo con los bloques soportados por el canal

<Tip>
  Prueba el canal con un usuario real de tu organización antes de publicarlo, para confirmar que el messaging endpoint quedó bien configurado en el Portal de Desarrolladores de Teams.
</Tip>