Message

El componente Message permite crear un objeto de mensaje que se puede usar en flujos de chat dentro del dashboard de Nappai. Con él, puedes registrar lo que dice un usuario o la máquina y asociarlo a una sesión específica, lo que facilita el seguimiento y la continuidad de las conversaciones.

¿Cómo funciona?

Internamente, el componente toma los valores que le das (quién envía el mensaje, el nombre del remitente, el texto y la ID de la sesión) y construye un objeto Message. Este objeto incluye:

• text: el contenido del mensaje.
• sender: indica si el mensaje proviene de la “Machine” o del “User”.
• sender_name: opcionalmente, el nombre del remitente.
• flow_id: el identificador del flujo actual en el que se ejecuta el componente.
• session_id: la ID que enlaza el mensaje con una conversación previa.

El componente no llama a ninguna API externa; todo el procesamiento ocurre localmente dentro del flujo de Nappai.

Entradas

Campos de Entrada

• Sender Type: Elige quién envía el mensaje. Puedes seleccionar Machine (para mensajes generados por la IA) o User (para mensajes del usuario).

  • Visible en: Todas las configuraciones.

• Sender Name: Escribe el nombre del remitente. Si lo dejas vacío, el sistema usará un valor por defecto.

  • Visible en: Todas las configuraciones.

• Text: Escribe el contenido del mensaje que quieres enviar o registrar.

  • Visible en: Todas las configuraciones.

• Session ID: Proporciona la ID de la sesión a la que pertenece este mensaje. Si no lo indicas, el mensaje no se asociará a ninguna conversación previa.

  • Visible en: Todas las configuraciones.
  • Info: Session ID of the chat history.

Salidas

El componente devuelve un objeto Message que contiene toda la información del mensaje creado. Este objeto puede conectarse a otros componentes que necesiten leer o almacenar mensajes, como un historial de chat, un analizador de sentimiento o un motor de respuesta automática.

Ejemplo de Uso

Supongamos que quieres registrar la respuesta de un usuario a una pregunta automática:

1. Configura el componente:

   • Sender Type: User
   • Sender Name: Juan Pérez
   • Text: Me gustaría saber el estado de mi pedido.
   • Session ID: session_12345

2. Conecta la salida a un componente de Chat History para que el mensaje quede guardado en el historial de la sesión.

3. Resultado: El flujo crea un objeto Message con los datos proporcionados y lo pasa al historial, donde se mostrará en la conversación.

Componentes Relacionados

• Chat History – Guarda y muestra los mensajes de una sesión.
• Response Generator – Genera respuestas automáticas basadas en mensajes entrantes.
• Session Manager – Administra la creación y cierre de sesiones de chat.

Consejos y Mejores Prácticas

• Usa siempre una Session ID para mantener la continuidad de la conversación y evitar mezclar mensajes de distintas sesiones.
• Define Sender Name cuando sea posible; ayuda a los usuarios a identificar quién está hablando.
• Valida el texto antes de enviarlo para evitar caracteres especiales que puedan romper el flujo.
• Revisa el flujo de datos: conecta la salida del componente a un registro o a un analizador para aprovechar la información del mensaje.

Consideraciones de Seguridad

• La Session ID puede contener información sensible sobre la conversación. Asegúrate de que solo usuarios autorizados tengan acceso a ella.
• Si el mensaje incluye datos personales, considera aplicar cifrado o anonimización antes de almacenarlo.
• Evita exponer la salida del componente en interfaces públicas sin la debida autorización.