Skip to main content
Este ejemplo demostrará cómo implementar un flujo de trabajo básico de respuesta automática utilizando n8n + modelos de lenguaje grandes: Al recibir un mensaje entrante, YCloud activa un flujo de trabajo de n8n mediante un webhook, invoca un modelo de lenguaje grande para generar una respuesta y envía el mensaje de vuelta al usuario a través de la API de YCloud.
YCloud AI Agent proporciona una base de conocimientos de IA integrada, corpus y flujos de trabajo automatizados. Consulta AI Agent para obtener más detalles.

​
Resumen general

Captura de pantalla del producto YCloud

​
Evento de Webhook

Al configurar el evento de Webhook, establece el método HTTP en POST, la respuesta en Retorno inmediato (Immediate Return) y el código de estado de respuesta en 200.
Asegúrate de proteger tu URL de Webhook y de garantizar que solo se devuelva un código de estado 200.
Captura de pantalla del producto YCloud Debes seleccionar WhatsApp.inbound_message.received dentro del evento de Webhook de YCloud. Al activarse el Webhook de YCloud, el nodo de Webhook de n8n recibirá los datos completos de inbound_message y los analizará automáticamente en campos utilizables. Como se ilustra a continuación: Captura de pantalla del producto YCloud Estos campos servirán como datos de entrada para los nodos posteriores (como Data Table, AI Agent, HTTP Request, etc.) y se pueden referenciar mediante Expression.

​
Data Table

​
Diseño de Data Table

​
Insert Row

Este nodo se utiliza para escribir los datos recibidos mediante webhooks en una tabla de datos para su posterior consulta o gestión de estado.
  • Admite coincidencia manual o coincidencia automática.
  • La coincidencia automática requiere que los nombres de los campos sean idénticos.
  • Puedes arrastrar los campos directamente desde el panel Input a los elementos de configuración, y n8n generará automáticamente la Expression.
Captura de pantalla del producto YCloud

​
Get Row

Este nodo se utiliza para leer datos existentes de la Data Table. La condición se puede definir como desees. En esta mejor práctica, utilizamos wamid como condición de coincidencia. Captura de pantalla del producto YCloud Dentro de este nodo, generalmente es necesario configurar condiciones de coincidencia (Condition). Este método se utiliza comúnmente para determinar si un mensaje ha sido procesado o para recuperar el contexto histórico.

​
AI Agent

​
1. Configuración del modelo

Antes de utilizar el AI Agent, configura la información del modelo correspondiente (como OpenRouter, Ollama, etc.) dentro de Credentials. Esta sección utilizará OpenRouter para la configuración. Las capturas de pantalla de la configuración de Credentials se omiten aquí; simplemente utiliza las API pertinentes proporcionadas por OpenRouter. Puedes seleccionar tu modelo preferido y el formato de retorno; para este ejemplo de mejores prácticas, elige grok-3 con formato TXT. Captura de pantalla del producto YCloud

​
2. Nodo AI Agent

Dentro del nodo AI Agent:
  • Redactar el prompt
  • Utiliza expresiones para referenciar campos de webhooks o tablas de datos como entrada. Puedes redactar el prompt que desees aquí; no se requieren adiciones. El contenido del prompt se puede personalizar libremente según los requisitos comerciales.
Captura de pantalla del producto YCloud Puedes seleccionar diferentes herramientas para conectarlas al nodo AI Agent; simplemente vincúlalas al nodo. Captura de pantalla del producto YCloud
Nota: El AI Agent admite un mecanismo de memoria extendido (Memory), lo que permite la gestión del contexto a través de bases de datos u otros métodos de almacenamiento.
Aquí puedes ver la información de salida final del modelo. Captura de pantalla del producto YCloud

​
Merge

El nodo Merge se utiliza para combinar los datos de salida de varios nodos, preparándolos para solicitudes de API posteriores. Captura de pantalla del producto YCloud Los patrones comunes incluyen:
  • Append
  • Combine
  • Merge by Index
En el ejemplo actual, se emplea el patrón merge para concatenar múltiples salidas en una sola estructura de datos para su uso por parte del nodo HTTP Request.

​
HTTP Request

Por último, invoca la interfaz de envío de mensajes de YCloud a través del nodo HTTP Request. Captura de pantalla del producto YCloud
  • Puedes utilizar los ejemplos de cURL en la referencia de API de YCloud para una configuración rápida. Inserta tu clave de API en el encabezado X-API-Key.
  • Arrastra el campo combinado del paso anterior al cuerpo de la solicitud.
Ten en cuenta que los roles de remitente y destinatario están invertidos aquí, ya que esto constituye un mensaje de respuesta.
  • Utiliza Expression para completar dinámicamente el contenido del mensaje, los destinatarios y otros parámetros.
En este punto, se ha configurado un flujo de trabajo completo de n8n que comprende Webhook → Modelo de lenguaje grande → Respuesta automática.

​
Resumen

Siguiendo los pasos anteriores, puedes crear rápidamente un flujo de trabajo de respuesta automática utilizando n8n para lograr:
  • Escucha de Webhook
  • Procesamiento de datos de mensajes
  • Generación automatizada de contenido con LLM
  • Respuesta a los usuarios a través de la API de YCloud
Este ejemplo sirve como punto de partida para la integración mediante n8n.