1.2 Cómo funciona n8n: domina los nodos, conexiones, flujos y la lógica detrás de automatizaciones profesionales
Cómo funciona n8n
Ya tienes el mapa de tu proceso en papel. Ahora toca entender la herramienta donde lo vas a construir. n8n no es solo un software — es un lenguaje visual para describir cómo deben fluir los datos entre sistemas. Quien entiende su lógica interna construye automatizaciones robustas. Quien solo copia tutoriales, construye automatizaciones frágiles.
En este subtema diseccionamos n8n por completo: su interfaz, sus piezas fundamentales, cómo viajan los datos, qué son las expresiones y cómo manejar errores como un profesional. Al terminar, podrás leer cualquier workflow y entender exactamente qué hace — antes de ejecutarlo.
n8n es como una cadena de producción visual.
Cada nodo es una estación de trabajo. Los datos son el producto que pasa entre ellas.
Imagina una fábrica donde el primer puesto recibe materias primas (el trigger), cada estación las transforma de alguna forma (los nodos), los inspectores de calidad toman decisiones de ruta (los nodos If), y al final el producto terminado sale por el último puesto (el nodo de salida). Tu trabajo es diseñar la línea de producción, no operar cada máquina manualmente.
Antes de crear tu primer nodo, oriéntate en el espacio de trabajo. n8n tiene 5 zonas principales — cada una con un propósito específico:
① Biblioteca de nodos
Triggers
Actions
Core nodes
Services
AI nodes
② Canvas central
Webhook
Trigger
AI Agent
IF
Condition
WhatsApp
Send
③ Configuración del nodo
Nodo activo
Condición
Operador
④ Historial de ejecuciones
① Panel de nodos
Biblioteca de todos los nodos. Búsqueda por nombre o categoría. Arrastra al canvas para agregarlo.
② Canvas central
Espacio de trabajo visual. Conectas nodos arrastrando desde la salida de uno a la entrada del siguiente.
③ Configuración del nodo
Al seleccionar un nodo aparecen sus parámetros, credenciales y las expresiones para datos dinámicos.
④ Historial de ejecuciones
Registro de cada corrida: éxitos, errores y los datos exactos que pasaron por cada nodo.
Regla fundamental: Todo workflow empieza con exactamente UN nodo Trigger. Sin trigger, no hay automatización — solo un diagrama. El trigger es el corazón que pone en marcha todo lo demás.
Trigger Nodes
El punto de inicio obligatorio
Monitorean un evento y disparan el workflow cuando ocurre. Pueden ser activos (escuchan en tiempo real) o pasivos (se ejecutan en horarios programados).
Action Nodes
Realizan acciones en servicios externos
Se conectan a APIs de terceros y ejecutan operaciones: crear registros, enviar mensajes, actualizar datos, subir archivos. Necesitan credenciales configuradas previamente.
Core Nodes
Manipulan y transforman datos
No se conectan a servicios externos — procesan los datos que ya fluyen por el workflow. Son la inteligencia interna: toman decisiones, transforman estructuras y controlan el flujo.
AI Nodes
IA y agentes integrados nativamente
Nodos especializados para integrar LLMs, embeddings, vectores y agentes directamente en tus flujos. No necesitas código para conectar Claude o GPT-4 a tu automatización.
Este es el concepto más importante de n8n. Los datos no se pasan como texto plano — se pasan como arrays de items en formato JSON. Cada nodo recibe una lista, la procesa y entrega una nueva lista al siguiente.
El Trigger recibe el evento y crea el primer item
Cuando un webhook recibe una petición, n8n crea un item con todos los datos del request. Este item es un objeto JSON con propiedades que puedes usar en los nodos siguientes.
[ { "json": { "nombre": "María García", "telefono": "523319126408", "mensaje": "Hola, quiero información sobre precios", "timestamp": "2025-05-11T09:30:00Z" } } ]
El nodo AI Agent procesa el item y agrega nuevas propiedades
El agente de IA analiza el mensaje y enriquece el item con nuevas propiedades: la intención detectada, el tema y la respuesta generada.
[ { "json": { "nombre": "María García", "telefono": "523319126408", "mensaje": "Hola, quiero información sobre precios", "intencion": "consulta_precio", "respuesta": "Hola María, con gusto te comparto nuestro catálogo...", "es_lead_nuevo": true } } ]
El nodo IF divide el flujo según una condición
El nodo IF evalúa {{ $json.intencion }} y envía el item por la rama “true” (consulta de precio) o “false” (otra intención). El mismo item sigue fluyendo por la rama correspondiente.
El nodo WhatsApp usa las propiedades del item para enviar
El nodo de salida referencia las propiedades del item usando expresiones. No escribe valores fijos — lee los datos que vienen del flujo.
To: {{ $json.telefono }} ← 523319126408 Body: {{ $json.respuesta }} ← "Hola María, con gusto..."
¿Qué es una expresión? En lugar de escribir un valor fijo en un campo (“Hola María”), escribes una referencia dinámica que n8n evalúa en tiempo real usando los datos que fluyen por el workflow. Todo lo que va entre {{ }} es una expresión.
Acceder a propiedad del item actual
La más usada. Lee una propiedad del item que está procesando el nodo en ese momento. Ejemplo: {{ $json.nombre }} → “María García”
Acceder a datos de un nodo específico
Cuando necesitas datos de un nodo anterior que ya no está en el flujo actual. Ejemplo: recuperar la respuesta del AI Agent desde el nodo de WhatsApp.
Transformaciones en línea
Puedes aplicar métodos de JavaScript directamente en las expresiones. Ejemplo: {{ $json.nombre.split(" ")[0] }} → solo el primer nombre.
Variables del sistema
n8n expone variables globales: $now (fecha y hora actual), $workflow.id, $execution.id.
Operador ternario — decisiones en línea
Para lógica simple directamente en el campo, sin necesidad de un nodo IF completo. Ejemplo: clasificar un ticket promedio según el monto.
Modo de prueba y desarrollo
Al hacer clic en “Test workflow”, el flujo se ejecuta una sola vez con los datos que llegan en ese momento o con datos de prueba que tú insertas. El trigger no queda escuchando.
- Cada nodo muestra exactamente los datos de entrada y salida en tiempo real
- Puedes hacer clic en cualquier nodo y ver su JSON completo
- Los errores aparecen inmediatamente con el mensaje exacto
- El workflow no se activa — solo corre una vez y para
- Usa este modo siempre que estés construyendo o depurando
Modo activo — corre solo
Al activar el switch de “Active” en la parte superior, el workflow queda en modo producción. El trigger comienza a monitorear su fuente y ejecuta el flujo automáticamente cuando se cumple la condición.
- El workflow corre sin que nadie intervenga — 24/7 si el servidor está encendido
- Cada ejecución queda registrada en el historial con sus datos
- Los errores no aparecen en pantalla — quedan en el log de ejecuciones
- Solo activa un workflow cuando ya lo probaste en modo manual
- Para editarlo, desactívalo primero para no interrumpir ejecuciones en curso
Un workflow profesional anticipa que las cosas pueden fallar: una API puede estar caída, un dato puede llegar vacío, una conexión puede timeout. n8n tiene tres formas de manejar esto:
🛑 Stop and Error
El workflow se detiene completamente cuando un nodo falla y marca la ejecución como error. Es el comportamiento por defecto. Ideal cuando un fallo en cualquier paso hace inútil todo lo que sigue.
Cuándo usarlo: En procesos donde todos los pasos son críticos y encadenados (crear lead → notificar → registrar).
⚠️ Continue on Error
El workflow sigue ejecutándose aunque un nodo falle, pasando un item vacío o el error como dato al siguiente nodo. Configurable por nodo individual.
Cuándo usarlo: Cuando procesas lotes de datos y no quieres que un item malo bloquee todo el batch.
🔔 Error Workflow
Un workflow secundario que se ejecuta automáticamente cuando el principal falla. Puede enviar una alerta por WhatsApp, crear un ticket en el CRM o intentar una acción alternativa.
Cuándo usarlo: En workflows de producción críticos donde necesitas saber inmediatamente si algo falló.
💡 Regla de oro en producción: Todo workflow activo debe tener configurado un Error Workflow que envíe una notificación. Si tu automatización falla silenciosamente a las 2 AM, no lo sabrás hasta que el cliente se queje.
⚡ Tips de quien ya construyó workflows en producción
Nombra tus nodos siempre
n8n los llama “IF1”, “Set2”. Renómbralos con nombres descriptivos: “Detectar intención” en lugar de “AI Agent1”. Lo agradecerás en 3 semanas.
Usa notas (Sticky Notes)
n8n tiene un nodo de nota adhesiva. Documenta dentro del canvas qué hace cada sección del workflow. Es el README de tu automatización.
Prueba nodo por nodo
No ejecutes el workflow completo hasta haber probado cada nodo individualmente. Haz clic derecho en un nodo → “Execute step” para probarlo solo.
Guarda versiones
Antes de hacer cambios grandes a un workflow en producción, duplícalo. n8n no tiene control de versiones nativo — tu backup eres tú.
Inspecciona el JSON de cada nodo
En modo test, haz clic en el nodo ejecutado y ve la pestaña “Output”. Ahí está el JSON exacto que sale — úsalo para construir las expresiones del nodo siguiente.
Itera en pequeño
Construye el workflow en partes: trigger + primer nodo → prueba. Agrega el segundo → prueba. No construyas todo y pruebes al final.
🎯 Lo que debes recordar del subtema 1.2
4 tipos de nodo
Trigger (inicio), Action (servicios externos), Core (lógica interna) y AI (inteligencia artificial). Cada workflow empieza con un trigger.
Los datos son JSON
Los items fluyen como arrays JSON. Cada nodo recibe, procesa y entrega una lista de objetos con propiedades accesibles por expresiones.
Expresiones {{ }}
Todo lo que va entre dobles llaves es dinámico. $json.campo es la forma de referenciar datos del flujo.
Manual antes de Producción
Prueba siempre en modo Manual hasta que el workflow funcione perfectamente. Solo entonces actívalo en producción.
Siempre un Error Workflow
En producción, configura siempre un workflow de error que te notifique cuando algo falla. Nunca dejes una automatización crítica sin monitoreo.
Nombra y documenta
Nodos con nombres descriptivos y notas en el canvas. Tu yo del futuro te lo agradecerá cuando tengas que editar un workflow de hace 2 meses.
Comentarios