Crea un nuevo workflow

1. Entra a tu instancia de N8N y haz clic en + Create Workflow o Add Workflow.
2. Asigna un nombre descriptivo, por ejemplo ChatCielo - Atención WhatsApp.
3. Haz clic en + Add first step para agregar el primer nodo.

Configura el nodo Webhook como disparador

1. Busca y selecciona el nodo Webhook.
2. Configura los siguientes campos:

3. Haz clic en Execute Node o guarda el workflow para que N8N genere la Webhook URL.

La URL se verá así:

https://tu-instancia.n8n.cloud/webhook/chatcielo-entrada

o en versión de prueba:

https://tu-instancia.n8n.cloud/webhook-test/chatcielo-entrada

Extrae y transforma los datos del mensaje

Agrega un nodo Set (o Code si necesitas lógica avanzada) después del Webhook.

Opción A — Nodo Set (simple, sin código):

Configura los campos a extraer del payload de ChatCielo:

Opción B — Nodo Code (lógica avanzada):

// Nodo Code en N8N — extrae datos y genera respuesta personalizada
const body = $input.first().json;
 
const name = body.name || body.pushName || 'amigo';
const phoneNumber = body.phoneNumber;
const protocol = body.protocol;
const text = (body.message?.text || '').toLowerCase();
 
let reply = '';
 
if (text.includes('precio') || text.includes('cotización') || text.includes('cuánto cuesta')) {
  reply = `¡Hola ${name}! 👋 Te preparo la cotización en un momento. Tu protocolo es ${protocol} — un asesor te contactará con los detalles.`;
} else if (text.includes('pedido') || text.includes('estado') || text.includes('envío')) {
  reply = `Hola ${name}, consulto el estado de tu pedido. Protocolo ${protocol} — dame un momento y te confirmo. 📦`;
} else if (text.includes('hablar con asesor') || text.includes('asesor humano')) {
  reply = `Perfecto ${name}, te derivo con un asesor humano ahora. Protocolo ${protocol}.`;
} else {
  reply = `¡Hola ${name}! Gracias por escribirnos. ¿En qué puedo ayudarte hoy? (Protocolo ${protocol})`;
}
 
return [{ reply, phoneNumber, protocol, name }];

Activa el modo de prueba en N8N

En N8N, haz clic en Execute Workflow (o Listen for Test Event si usas /webhook-test/). El workflow quedará esperando un POST.

Envía un POST de prueba con cURL

Abre tu terminal y ejecuta:

curl -X POST https://tu-instancia.n8n.cloud/webhook-test/chatcielo-entrada \
  -H "Content-Type: application/json" \
  -d '{
    "event": "message.received",
    "channelId": "12",
    "protocol": "48291",
    "phoneNumber": "+54 11 1234 5678",
    "name": "María González",
    "email": "maria@ejemplo.com",
    "pushName": "María",
    "message": {
      "id": "wamid.test123",
      "type": "text",
      "text": "Hola, quiero saber el precio del producto",
      "timestamp": "2026-05-13T14:30:00Z"
    }
  }'

Respuesta esperada (Opción A):

{
  "reply": "¡Hola María González! 👋 Te preparo la cotización en un momento. Tu protocolo es 48291 — un asesor te contactará con los detalles."
}

Si recibes el reply correctamente, tu workflow está listo.

Activa el workflow para producción

En N8N, cambia la URL de /webhook-test/ a /webhook/ y activa el toggle Active (arriba a la derecha). El workflow quedará escuchando permanentemente.

Pega la Webhook URL en ChatCielo

1. Ve a Canales > Tu canal > Integración / Automatización > N8N (Webhook).
2. Pega la Webhook URL de producción (con /webhook/, no /webhook-test/):

https://tu-instancia.n8n.cloud/webhook/chatcielo-entrada

3. Selecciona Método: POST y Evento: Mensaje entrante.
4. Si protegiste el webhook con Header Auth, agrega el header correspondiente.
5. Haz clic en Guardar.

Prueba de punta a punta

1. Desde tu celular personal, envía un mensaje de WhatsApp al número conectado al canal.
2. Verifica que N8N registre la ejecución en Executions (panel lateral de N8N).
3. Confirma que el cliente reciba la respuesta en WhatsApp.
4. Revisa en ChatCielo Atenciones > Panel de Chats que la conversación y el protocolo {{protocol}} se hayan registrado correctamente.

Monitorea y ajusta

• En N8N ve a Executions para ver cada ejecución, payload recibido y respuesta enviada.
• Si algo falla, revisa el Error Workflow en N8N y los logs de ejecución.
• Ajusta tu lógica (nodos Code, condiciones, integraciones CRM) y vuelve a probar con cURL antes de actualizar en producción.