Disparador de Mensaje Enviado por Agente

El disparador Message Sent by Agent en OneChat se utiliza para capturar mensajes enviados por un agente humano durante una conversación y activar flujos de trabajo automatizados basados en esos mensajes. Esta documentación proporciona una guía paso a paso sobre cómo configurar y usar este disparador, incluidos los campos personalizados y un flujo de ejemplo que envía una notificación por correo electrónico.

Paso 1: Crear el disparador

Navega a la sección de disparadores:

• En OneChat, ve a Triggers en el menú lateral izquierdo.

• Haz clic en Internal Functions.

• Haz clic en el botón New Trigger (esquina superior derecha).

Selecciona el evento:

• En la lista de eventos disponibles, selecciona Message Sent by Agent.

Activa el disparador:

• Habilita el disparador cambiando el interruptor a Activated.

• Asigna un nombre adecuado al disparador (por ejemplo, Agent Message Trigger).

Guarda los campos personalizados:

• Asigna campos personalizados para almacenar los detalles clave del mensaje:

Agent_ID → Almacena el ID único del agente que envió el mensaje.

• Time → Almacena la marca de tiempo en la que se envió el mensaje.

• Agent_Message → Almacena el contenido del mensaje.

Guarda y confirma:

• Haz clic en Save para confirmar la configuración del disparador.

• El disparador ahora aparecerá en la lista de disparadores activos.

Paso 2: Crear un flujo automatizado

Una vez que el disparador esté configurado, podemos crear un flujo que use los datos del mensaje del agente.

Abre el Flow Builder:

• Crea un nuevo flujo de trabajo o edita uno existente.

• Agrega un nodo de acción que procese los datos del disparador y envíe, por ejemplo, una notificación por correo electrónico (puedes crear otras acciones si lo prefieres).

Agrega una acción de notificación por correo electrónico:

• Selecciona la acción Send Email Notification.

• Configura los ajustes del correo electrónico:

Email Profile: Elige el perfil SMTP.

• To Email: Ingresa el correo electrónico del destinatario.

• Subject: Define un asunto relevante como Agent Message.

• Message: Usa el campo Agent_Message para incluir el contenido del mensaje del agente en el cuerpo del correo.

Guarda y publica:

• Haz clic en Save para guardar la configuración.

• Publica el flujo para activarlo.

Paso 3: Probar el disparador

Envía un mensaje como agente:

• Abre una conversación y envía un mensaje como agente.

• El disparador debe capturar el mensaje y almacenar los detalles en los campos asignados.

Revisa la notificación por correo electrónico:

• Verifica que se reciba el correo configurado con los detalles correctos del mensaje.

Ejemplo de salida JSON

Los datos del mensaje almacenado tendrán la siguiente estructura:

{
  "type": "text",
  "agent_id": 51263,
  "time": "2025-01-30T01:43:22Z",
  "text": "John Doe:\nMessage by Vitor",
  "url": ""
}

Este objeto JSON contiene:

• type: El tipo de mensaje (por ejemplo, texto, imagen, etc.).

• agent_id: El ID único del agente.

• time: La marca de tiempo del mensaje.

• text: El contenido del mensaje.

• url: Un marcador de posición para archivos adjuntos multimedia (si los hay).

Conclusión

El disparador Message Sent by Agent es útil para automatizar respuestas y acciones basadas en las interacciones del agente. Siguiendo los pasos de esta guía, puedes capturar de manera eficiente los mensajes del agente e integrarlos en flujos de trabajo, como notificaciones por correo electrónico u otros procesos automatizados.