Channel

Este componente te permite interactuar con los canales de Microsoft Teams desde tu dashboard de Nappai. Puedes consultar equipos y canales existentes, obtener los miembros de un canal o crear un nuevo canal con la configuración que necesites.

¿Cómo funciona?

El componente se conecta a la API de Microsoft Teams mediante una credencial previamente configurada. Cuando seleccionas una operación, Nappai envía la solicitud correspondiente a la API y devuelve los datos en formato Data o los convierte en una herramienta (Tool) que puede ser usada por los agentes de IA. Si activas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la automatización de tareas en lote.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Get Teams: Recupera una lista de los equipos de Microsoft Teams disponibles.
• Get Teams Channels: Obtiene los canales dentro de un equipo especificado.
• Get Channel Members: Lista los miembros de un canal concreto.
• Create Channel: Crea un nuevo canal dentro de un equipo.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

• Operation: Selecciona la operación que quieres ejecutar.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Credential: Elige la credencial de Microsoft Teams que configuraste previamente.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Teams ID: ID del equipo de Microsoft Teams donde quieres trabajar.

  • Visible en: Get Teams Channels, Get Channel Members, Create Channel

• Top Teams Count: Número de equipos superiores a recuperar (valor por defecto: 20).

  • Visible en: Get Teams

• Channel ID: ID del canal que quieres consultar.

  • Visible en: Get Channel Members

• Channel Description: Descripción para el nuevo canal.

  • Visible en: Create Channel

• Channel Name: Nombre del canal que vas a crear.

  • Visible en: Create Channel

• Channel Type: Tipo de canal a crear (por ejemplo, estándar o privado).

  • Visible en: Create Channel

• Member Role: Rol del nuevo miembro del canal.

  • Visible en: Create Channel

• User ID: ID del usuario que se añadirá al canal.

  • Visible en: Create Channel

• Tool Name: Nombre de la herramienta que se mostrará al agente cuando el componente esté conectado como herramienta.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Tool Description: Descripción detallada de lo que hace esta herramienta.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Tools arguments metadata: Define los metadatos de los argumentos para las herramientas.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

• Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.

  • Visible en: Get Teams, Get Teams Channels, Get Channel Members, Create Channel

Nota sobre credenciales

1. Configura primero la credencial Microsoft Teams en la sección de credenciales de Nappai.
2. Luego selecciona esa credencial en el campo Credential del componente.
   La credencial requiere los siguientes datos:

• Client ID
• Client Secret
• Tenant ID
• Microsoft Teams Scope

Salidas

• Data: Devuelve los datos obtenidos de la API de Microsoft Teams (por ejemplo, lista de equipos, canales o miembros).
• Tool: Convierte la operación en una herramienta que puede ser utilizada por los agentes de IA dentro de Nappai.

Ejemplo de Uso

Obtener los equipos disponibles

1. Arrastra el componente Channel al flujo.
2. En el campo Operation, selecciona Get Teams.
3. (Opcional) Ajusta Top Teams Count si quieres limitar la cantidad de equipos devueltos.
4. Conecta la salida Data a otro componente que necesite la lista de equipos.

Crear un nuevo canal

1. Arrastra el componente Channel al flujo.
2. Selecciona Create Channel en el campo Operation.
3. Proporciona el Teams ID del equipo donde crearás el canal.
4. Rellena Channel Name, Channel Description y Channel Type.
5. (Opcional) Añade un nuevo miembro seleccionando User ID y Member Role.
6. Ejecuta el flujo y verifica la salida Data para confirmar que el canal se creó correctamente.

Componentes Relacionados

• Microsoft Teams Connector – Conecta Nappai con Microsoft Teams y gestiona la autenticación y autorización.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar listas de equipos o canales en lote.
• Verifica que la credencial tenga los permisos adecuados (scope) para las operaciones que vas a ejecutar.
• Cuando crees canales privados, asegúrate de que el usuario que ejecuta la operación tenga los permisos necesarios.
• Aprovecha la salida Tool para que los agentes de IA puedan llamar a esta operación de forma dinámica dentro de flujos más complejos.

Consideraciones de Seguridad

• La credencial de Microsoft Teams contiene información sensible (Client Secret). No la compartas ni la expongas en el código.
• Asegúrate de que solo los usuarios autorizados tengan acceso a la sección de credenciales en Nappai.
• Revisa los scopes asignados a la credencial para limitar el acceso solo a las operaciones necesarias.