Online Meetings

El componente Online Meetings te permite interactuar con las reuniones de Microsoft Teams directamente desde el dashboard de Nappai. Con él puedes listar reuniones, obtener detalles de una reunión específica, descargar transcripciones y acceder al chat de la reunión. Todo se hace a través de la API de Microsoft Teams, por lo que necesitas una credencial configurada previamente.

¿Cómo funciona?

El componente envía peticiones HTTP a la API de Microsoft Teams. Cuando seleccionas una operación, Nappai construye la solicitud con los parámetros que hayas introducido y la envía al servicio de Teams. La respuesta se devuelve como un objeto Data que puedes usar en otros componentes, o como un objeto Tool que un agente de IA puede invocar directamente.

Operaciones

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

• List Meetings: Obtiene una lista de reuniones dentro de un rango de fechas y con un número máximo de resultados.
• Get Meeting Details: Devuelve información detallada de una reunión específica usando su ID.
• Download Transcript: Descarga la transcripción de una reunión a partir del ID de la transcripción.
• Get Meeting Chat: Recupera el historial de chat de una reunión usando su ID.

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:

• End Time: End time of the meeting.
  • Visible en: List Meetings
• Start Time: Start time of the meeting.
  • Visible en: List Meetings
• Operation: Operación a ejecutar.
  • Visible en: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
• Attendees: Email addresses of attendees (comma-separated).
• Auto Admit: Who gets automatically admitted to the meeting.
• Lobby Bypass: Who can bypass the meeting lobby.
• Mapping Mode: Enable mapping mode to process multiple data records in batch.
  • Visible en: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
• Max Results: Maximum number of results to return.
  • Visible en: List Meetings, Get Meeting Chat
• Meeting ID: ID of the online meeting.
  • Visible en: Get Meeting Details, Download Transcript, Get Meeting Chat
• Meeting Subject: Subject/title of the meeting.
• Transcript ID: ID of the transcript to download.
  • Visible en: Download Transcript
• Tool Name: The name of the tool that will be used when this component is connected as a tool.
  • Visible en: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
• Tool Description: A detailed description of what this tool does.
  • Visible en: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat
• Tools arguments metadata: Defines the arguments metadata for the tools.
  • Visible en: List Meetings, Get Meeting Details, Download Transcript, Get Meeting Chat

Credencial
Este componente requiere una credencial de tipo Microsoft Teams.

1. Configura primero la credencial en la sección de credenciales de Nappai.
2. Luego selecciona esa credencial en el campo Credential del componente.
   La credencial necesita los datos: Client ID, Client Secret, Tenant ID y Microsoft Teams Scope, los cuales se configuran en el portal de Microsoft Entra.

Salidas

• Data: Resultado de la operación en formato de datos que puede ser usado en otros componentes.
• Tool: Representación del componente como herramienta que un agente de IA puede invocar.

Ejemplo de Uso

1. Listar reuniones en un rango de fechas

1. Activa Mapping Mode si quieres procesar varias fechas a la vez.
2. En Start Time escribe 2024-10-01T08:00:00Z.
3. En End Time escribe 2024-10-01T18:00:00Z.
4. En Max Results escribe 50.
5. Selecciona Operation = List Meetings.
6. Ejecuta el flujo.
   El componente devolverá una lista de reuniones dentro de ese rango.

2. Obtener detalles de una reunión específica

1. En Meeting ID escribe el ID de la reunión que quieres consultar.
2. Selecciona Operation = Get Meeting Details.
3. Ejecuta el flujo.
   El resultado incluirá información como el asunto, asistentes, hora de inicio y fin, etc.

Plantillas

(No se incluyen plantillas que utilicen este componente.)

Componentes Relacionados

• Microsoft Teams Calendar – Gestiona eventos y citas en el calendario de Teams.
• Microsoft Teams Chat – Envía y recibe mensajes de chat dentro de Teams.
• Microsoft Teams Files – Maneja archivos compartidos en reuniones y canales.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar listas de reuniones o IDs de forma batch.
• Limita el número de resultados con Max Results para evitar respuestas muy grandes.
• Cuando descargues transcripciones, verifica que el Transcript ID corresponda a la reunión correcta.
• Configura la credencial de Microsoft Teams una sola vez y reutilízala en todos los componentes que la necesiten.

Consideraciones de Seguridad

• La credencial de Microsoft Teams contiene información sensible (Client Secret). No la compartas ni la expongas en el flujo.
• Asegúrate de que solo usuarios autorizados tengan acceso a la sección de credenciales en Nappai.
• Revisa los permisos de la aplicación en Microsoft Entra para limitar el acceso solo a los recursos necesarios (Calendario, Chat, etc.).