Saltearse al contenido
Nappai Documentation

Chat Messages

El componente Chat Messages te permite interactuar con los chats de Microsoft Teams directamente desde el dashboard de Nappai. Con él puedes enviar mensajes, leer los últimos mensajes de un chat, obtener un mensaje específico, responder a un mensaje existente, y trabajar con mensajes directos (1‑a‑1). Además, puedes adjuntar archivos o enlaces y usar el modo de mapeo para procesar varios registros a la vez.

¿Cómo funciona?

El componente se conecta a la API de Microsoft Teams mediante una credencial previamente configurada (Client ID, Client Secret, Tenant ID y Scope). Cuando seleccionas una operación, el componente construye la solicitud correspondiente a la API y devuelve los datos recibidos. Si activas el Mapping Mode, el componente procesa cada registro de la entrada “Mapping Data” de forma individual, lo que permite enviar o leer mensajes 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:

  • Send Chat Message: Envía un mensaje a un chat de Teams.
  • Get Chat Messages: Recupera los últimos mensajes de un chat.
  • Get Chat Message: Obtiene un mensaje específico por su ID.
  • Reply to Message: Responde a un mensaje existente.
  • Get Direct Messages: Recupera los mensajes directos (1‑a‑1) de un usuario.
  • Send Direct Message: Envía un mensaje directo a un usuario.

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:

  • Attachments: Lista de archivos o enlaces que quieres enviar. Cada elemento debe ser un diccionario con las claves attachment_name, url, file_path o file_id.

    • Visible en: Send Chat Message, Send Direct Message

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

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message, Get Direct Messages, Send Direct Message

  • Chat ID: Identificador del chat de Teams donde se enviará o leerá el mensaje.

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message

  • Content Type: Tipo de contenido que vas a enviar (texto, archivo, etc.).

    • Visible en: Send Chat Message, Reply to Message, Send Direct Message

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

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message, Get Direct Messages, Send Direct Message

  • Message Count: Número de mensajes que quieres recuperar (por defecto 20).

    • Visible en: Get Chat Messages, Get Direct Messages

  • Message ID: Identificador del mensaje que quieres leer o al que quieres responder.

    • Visible en: Get Chat Message, Reply to Message

  • Message Text: Contenido del mensaje que vas a enviar.

    • Visible en: Send Chat Message, Reply to Message, Send Direct Message

  • Recipient Email: Correo electrónico del destinatario para un mensaje directo (dejar vacío para obtener todos los mensajes directos).

    • Visible en: Get Direct Messages, Send Direct Message

  • Tool Name: Nombre que se mostrará al agente cuando el componente se use como herramienta.

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message, Get Direct Messages, Send Direct Message

  • Tool Description: Descripción detallada de la herramienta para que el agente sepa cuándo usarla.

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message, Get Direct Messages, Send Direct Message

  • Tools arguments metadata: Metadatos de los argumentos que la herramienta acepta.

    • Visible en: Send Chat Message, Get Chat Messages, Get Chat Message, Reply to Message, Get Direct Messages, Send Direct Message

Nota: El campo Credential no aparece aquí porque debe configurarse en la sección de credenciales de Nappai antes de usar el componente.

Salidas

  • Data: Devuelve los datos recibidos de la API de Microsoft Teams (por ejemplo, la lista de mensajes o la confirmación de envío).
  • Tool: Si el componente se usa como herramienta, devuelve un objeto que el agente puede invocar.

Ejemplo de Uso

Enviar un mensaje a un chat

  1. Activa el componente Chat Messages.
  2. Selecciona la operación Send Chat Message.
  3. En Chat ID escribe o mapea el ID del chat.
  4. En Message Text escribe el texto que quieres enviar.
  5. (Opcional) Añade archivos en Attachments.
  6. Haz clic en Run.
    El componente enviará el mensaje y devolverá la respuesta de la API en la salida Data.

Obtener los últimos 10 mensajes de un chat

  1. Selecciona la operación Get Chat Messages.
  2. En Chat ID indica el chat.
  3. En Message Count escribe 10.
  4. Ejecuta el flujo.
    La salida Data contendrá una lista con los 10 mensajes más recientes.

Plantillas

(No se incluyen plantillas que utilicen este componente.)

Componentes Relacionados

  • MicrosoftTeamChannelsComponent – Gestiona canales de Teams.
  • MicrosoftTeamFilesComponent – Maneja archivos compartidos en Teams.

Consejos y Mejores Prácticas

  • Usa el Modo de Mapeo cuando necesites enviar o leer mensajes en lote; evita ejecutar el componente varias veces.
  • Incluye un identificador único en cada mensaje (por ejemplo, un número de ticket) para poder rastrear fácilmente la conversación.
  • Adjunta archivos solo cuando sea necesario; los archivos grandes pueden tardar más en cargarse.
  • Revisa los límites de la API de Microsoft Teams (por ejemplo, número máximo de mensajes por solicitud) para evitar errores.
  • Guarda la respuesta en la salida Data y conéctala a otros componentes que necesiten procesar la información (por ejemplo, un componente de análisis de sentimiento).

Consideraciones de Seguridad

  • La credencial Microsoft Teams debe guardarse en la sección de credenciales de Nappai y no debe compartirse públicamente.
  • Los mensajes enviados a través de este componente se transmiten cifrados por la API de Microsoft Teams.
  • Si usas el componente como herramienta para agentes, limita el acceso a la herramienta solo a agentes autorizados para evitar el envío de mensajes no deseados.