Chats

El componente Chats te permite interactuar con los chats de Microsoft Teams directamente desde tu dashboard de Nappai. Con él puedes obtener la lista de chats de un usuario, ver los miembros de un chat o añadir un nuevo miembro a un chat existente. Todo se hace con un solo componente, eligiendo la operación que necesites.

¿Cómo funciona?

El componente se conecta a la API de Microsoft Teams mediante una credencial que ya debes haber configurado en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los datos en formato Data o los convierte en un Tool que puede ser usado por los agentes de IA de Nappai. Si activas el Mapping Mode, puedes procesar varios registros a la vez, enviando una lista de valores y recibiendo una lista de resultados.

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 User Chats: Obtiene la lista de chats a los que pertenece un usuario.
• Get Chat Members: Devuelve los miembros de un chat específico.
• Add Chat Member: Añade un nuevo miembro a un chat existente.

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 User Chats, Get Chat Members, Add Chat Member

• Number of Chats: Número de chats a recuperar (valor por defecto: 20).

  • Visible en: Get User Chats

• Chat ID: ID del chat.

  • Visible en: Get Chat Members, Add Chat Member

• Chat Topic: Tema del nuevo chat.

• Initial Members: Miembros iniciales del nuevo chat.

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

  • Visible en: Get User Chats, Get Chat Members, Add Chat Member

• Member Role: Rol del nuevo miembro del chat.

  • Visible en: Add Chat Member

• Chats with User Email: Correo electrónico del usuario para encontrar chats con él.

  • Visible en: Get User Chats

• User ID: ID del usuario a añadir al chat.

  • Visible en: Add Chat Member

• Tool Name: Nombre del tool que se mostrará al agente cuando el componente se conecte como tool.

  • Visible en: Get User Chats, Get Chat Members, Add Chat Member

• Tool Description: Descripción detallada de lo que hace este tool.

  • Visible en: Get User Chats, Get Chat Members, Add Chat Member

• Tools arguments metadata: Define los metadatos de los argumentos del tool.

  • Visible en: Get User Chats, Get Chat Members, Add Chat Member

• Credential: Selecciona la credencial de Microsoft Teams que ya has configurado en Nappai.

  • Requisitos: Debes haber creado una credencial de tipo Microsoft Teams en la sección de credenciales de Nappai antes de usar este componente. La credencial necesita los datos de Client ID, Client Secret, Tenant ID y el Microsoft Teams Scope. Una vez creada, simplemente elige esa credencial en este campo.

Salidas

• Data: Resultado de la operación en formato de datos que puede ser usado en otros componentes.
• Tool: Representación del componente como un tool que puede ser llamado por los agentes de IA de Nappai.

Ejemplo de Uso

Obtener los chats de un usuario

1. Arrastra el componente Chats al flujo.
2. En el campo Operation, selecciona Get User Chats.
3. En Chats with User Email, escribe el correo electrónico del usuario (ej. usuario@ejemplo.com).
4. (Opcional) Ajusta Number of Chats si quieres más o menos resultados.
5. Conecta la salida Data a otro componente que necesite esa información.

Añadir un miembro a un chat

1. Arrastra el componente Chats al flujo.
2. En el campo Operation, selecciona Add Chat Member.
3. En Chat ID, introduce el ID del chat al que quieres añadir al usuario.
4. En User ID, escribe el ID del usuario que será añadido.
5. En Member Role, elige el rol que tendrá el nuevo miembro (ej. Member).
6. Conecta la salida Tool a un componente que invoque el tool, o la salida Data para ver el resultado.

Componentes Relacionados

• MicrosoftTeamChannelsComponent – Gestiona canales en Microsoft Teams.
• MicrosoftTeamMessagesComponent – Envía y recibe mensajes dentro de los chats y canales.

Consejos y Mejores Prácticas

• Revisa los límites de la API: Microsoft Teams impone límites de llamadas por minuto; evita hacer demasiadas peticiones en un corto período.
• Usa el Mapping Mode cuando necesites procesar listas de chats o usuarios; reduce la cantidad de componentes y mejora la velocidad.
• Guarda la salida en una variable para reutilizarla en pasos posteriores del flujo.
• Configura la credencial antes de usar el componente; sin ella, el componente no podrá conectarse a Teams.

Consideraciones de Seguridad

• La credencial de Microsoft Teams contiene información sensible (Client Secret). Asegúrate de que solo usuarios autorizados tengan acceso a la sección de credenciales de Nappai.
• Cuando compartas flujos que usan este componente, evita exponer la credencial en la descripción o en los logs.
• Si el flujo se ejecuta en un entorno compartido, revisa los permisos de la cuenta de Microsoft Teams para limitar el acceso solo a los recursos necesarios.