n8n desde cero: crea y entiende tu primer workflow

n8n permite conectar herramientas y ejecutar procesos sin construir desde cero toda la infraestructura de integración. Su editor visual ayuda, pero no convierte una automatización en segura por sí solo. El objetivo de esta guía es que entiendas qué sucede en cada paso antes de pulsar Active.

Respuesta rápida

Para crear tu primer workflow necesitas un disparador, uno o varios nodos de acción, datos de prueba y un resultado observable. Empieza con un proceso reversible: recibe un dato manual, normalízalo y decide si es válido. Ejecuta cada nodo, inspecciona su salida y añade la ruta de error antes de conectar sistemas de producción.

La versión corta para una empresa es esta: n8n no se aprende conectando veinte apps el primer día, sino entendiendo cómo viaja un dato desde que entra hasta que produce una consecuencia. Cuando sabes ver el item, leer su JSON, validar lo obligatorio y responder ante un fallo, ya puedes pasar a formularios, CRM, WhatsApp, facturas o informes.

Si tu objetivo es contratar o implantar n8n en Madrid, esta guía también te sirve para auditar a un proveedor. Una agencia seria no debería venderte "un flujo mágico", sino explicar qué dispara el workflow, qué dato se conserva, qué sistema manda, qué pasa con un duplicado y quién recibe una alerta cuando algo falla.

Las seis ideas que debes dominar

Un error frecuente es imaginar que cada nodo recibe una única ficha. n8n trabaja con items: una consulta puede devolver cien registros y el siguiente nodo procesará esa colección. Antes de diseñar, pregunta si quieres actuar sobre cada item, agruparlos o producir un único resumen.

La documentación oficial de n8n insiste en que los datos fluyen de nodo en nodo y que cada nodo recibe, procesa y devuelve resultados para el siguiente. Esa idea parece obvia, pero cambia cómo diseñas: no piensas en "la automatización" como una pantalla, sino como una cadena de transformaciones comprobables.

Qué es n8n explicado sin postureo

n8n es una plataforma de automatización de workflows. Un workflow es un proceso compuesto por nodos conectados. Un nodo puede recibir un evento, consultar una API, transformar datos, tomar una decisión, enviar un correo, crear un registro en un CRM o llamar a otro workflow. La referencia oficial de workflows en n8n es el punto correcto para entender esa estructura antes de copiar plantillas.

Lo que diferencia n8n de una simple integración puntual es la capacidad de combinar lógica visual, llamadas API, expresiones, JavaScript cuando hace falta, credenciales reutilizables, webhooks, ejecución programada y control de errores. Para una empresa esto significa que un proceso deja de depender de copiar y pegar datos entre herramientas.

Pero hay una trampa: que sea visual no significa que sea trivial. Una automatización que crea facturas, contesta WhatsApp o mueve leads tiene impacto real. Por eso conviene aprender n8n con un flujo pequeño antes de conectar sistemas críticos.

Cuándo tiene sentido aprender n8n

Tiene sentido aprender n8n si tu empresa repite tareas como estas:

• copiar leads de un formulario a un CRM;
• avisar al equipo cuando entra una oportunidad importante;
• guardar adjuntos en una carpeta con nombre correcto;
• preparar borradores de factura o presupuesto;
• resumir mensajes largos antes de revisarlos;
• clasificar incidencias por tipo;
• sincronizar datos entre tienda, ERP y email;
• generar informes semanales con datos de varias fuentes;
• preparar publicaciones o recordatorios de redes sociales;
• registrar respuestas de WhatsApp en una ficha interna.

No hace falta automatizar todo. De hecho, empezar por todo es una mala señal. El primer workflow debe demostrar aprendizaje, control y retorno.

Cuándo no empezaría con n8n

No empezaría por n8n si el proceso cambia cada semana, si nadie sabe quién decide, si los datos de origen son caóticos, si hay impacto legal o sanitario sin revisión, si no existe responsable interno o si la empresa espera que la herramienta arregle un problema de organización.

n8n puede ordenar el recorrido de un dato. No puede decidir por la empresa qué proceso tiene sentido. Si no sabes qué debe pasar cuando un cliente pide algo, la automatización solo hará más rápido el desorden.

La arquitectura mental de un workflow

Antes de abrir el editor, dibuja cuatro cajas:

Este mapa evita que tu primer workflow se convierta en una sucesión de nodos sin criterio. También permite explicarlo a una persona no técnica. Si no puedes explicar el proceso en una frase, todavía no lo tienes preparado.

Ejemplo: "cuando entra una solicitud de presupuesto, validamos nombre, email y servicio; si falta algo avisamos al equipo; si está completo creamos una oportunidad y registramos el origen".

Ese workflow es pequeño, pero ya contiene lo importante: entrada, validación, acción y evidencia.

Primer workflow: validar una solicitud

Construye este recorrido:

1. Manual Trigger para iniciar la prueba cuando tú decidas.
2. Edit Fields (Set) para crear name, email y source.
3. If para comprobar que nombre y correo tienen un formato mínimo.
4. Dos salidas: válido e inválido.

Introduce primero un caso correcto y luego datos incompletos. El valor de la prueba no está en ver una rama verde: está en confirmar que la entrada mala no llega al sistema siguiente.

El objetivo del ejercicio

No estás intentando montar un CRM entero. Estás aprendiendo a responder cinco preguntas:

1. ¿Dónde veo el dato que entra?
2. ¿Cómo cambio su estructura?
3. ¿Cómo decido si cumple una regla?
4. ¿Cómo pruebo una entrada incorrecta?
5. ¿Cómo evito activar un flujo que no entiendo?

Cuando domines eso, los workflows con Gmail, Holded, Sheets, WhatsApp, Meta Ads o una API propia dejan de parecer magia. Siguen siendo procesos con entradas, reglas y salidas.

Paso 1: define una entrada estable

En Edit Fields crea un ejemplo sin información real:

{
  "name": "Cliente de prueba",
  "email": "prueba@example.com",
  "source": "tutorial"
}

No uses datos personales de clientes para aprender. Si el workflow terminará tratando información sensible, diseña desde el principio quién puede verla y cuánto tiempo debe guardarse.

Añade después otro campo:

{
  "service": "automatizacion",
  "city": "Madrid"
}

Esto permite practicar dos decisiones sencillas: servicio válido y mercado. Si mañana el formulario incluye "SEO", "web" o "n8n", podrás derivar cada solicitud a una ruta distinta.

Paso 2: mira la salida de cada nodo

Ejecuta el primer nodo y abre su pestaña de salida. Comprueba nombres, tipos y estructura. Si email llega dentro de body.contact.email, la expresión debe reflejar esa ruta. No adivines la estructura por una captura de otro tutorial.

La documentación oficial sobre datos explica cómo se mueven los items entre nodos. Cuando una referencia pueda no existir, evita que una expresión frágil detenga todo el proceso: valida antes o usa un valor alternativo deliberado.

Si la ruta oficial cambia, busca en la documentación de n8n las secciones de trabajo con datos, estructura de datos y expresiones. La idea que debes conservar es la misma: el output de un nodo es el input del siguiente, y tu trabajo consiste en saber qué estructura pasa por cada punto.

Paso 3: prueba la condición

El nodo If debe responder una pregunta concreta. “¿El lead es bueno?” es ambiguo; “¿existen nombre y email con formato válido?” se puede probar. Separa validación técnica de decisión comercial.

Prueba como mínimo:

• entrada correcta;
• nombre vacío;
• email sin dominio;
• campo ausente;
• valor con espacios;
• repetición del mismo evento.

Anota el resultado esperado antes de ejecutar. Por ejemplo:

Esta tabla parece básica, pero evita el error de probar solo el camino feliz. En automatización, el camino feliz casi siempre funciona. Lo que rompe producción son los campos ausentes, duplicados, permisos caducados y respuestas inesperadas.

Qué son los items y por qué importan

En n8n, un nodo puede recibir varios items. Cada item lleva su propio JSON. Si una API devuelve diez contactos, el siguiente nodo puede procesar esos diez elementos. Eso tiene consecuencias:

• una acción puede ejecutarse diez veces;
• un error puede afectar solo a un item;
• una condición puede dividir la lista;
• una agregación puede convertir varios items en uno;
• una mala referencia puede leer el primer elemento y olvidarse del resto.

Para aprender, usa primero un item. Después prueba con tres. Si tu workflow solo funciona con un item, todavía no sabes cómo se comportará con una lista.

Qué son las expresiones

Las expresiones permiten usar datos dinámicos dentro de los parámetros de un nodo. Un ejemplo simple:

{{ $json.email }}

Eso lee el campo email del item actual. Si el email está dentro de customer.email, la expresión cambia:

{{ $json.customer.email }}

La documentación oficial de expresiones de n8n explica que se usan dentro de parámetros para establecer valores dinámicos. En la práctica, son el puente entre "este nodo tiene una caja de texto" y "esta caja usa el dato que llegó del formulario".

No intentes memorizar todas las variables el primer día. Aprende tres:

• $json: datos del item actual;
• referencias a nodos anteriores cuando necesitas datos de otro punto;
• funciones simples para texto, fechas o números.

Después profundiza en la guía de expresiones n8n y transformación de datos.

Edit Fields, If y Respond: tres nodos para aprender bien

Un primer workflow no necesita veinte nodos. Con tres familias puedes aprender mucho:

Edit Fields

Sirve para crear, renombrar o limpiar campos. Úsalo para normalizar datos pronto. Si un formulario manda telefono, otro manda phone y otro contact.mobile, convierte todo a un campo interno estable como phone.

If

Sirve para decidir. Debe hacer preguntas concretas: "¿existe email?", "¿el importe es mayor que cero?", "¿el servicio está en la lista permitida?". Evita condiciones vagas que mezclan validación técnica con criterio comercial.

Respond to Webhook

Si trabajas con webhooks, permite devolver una respuesta controlada. No lo necesitas en un Manual Trigger, pero conviene entenderlo pronto porque muchos procesos de empresa empiezan con una URL pública.

De Manual Trigger a Webhook

El Manual Trigger es perfecto para aprender porque tú decides cuándo ejecutar. Un webhook cambia el escenario: un sistema externo llama a tu workflow. Eso exige más disciplina:

• URL de prueba y URL de producción no son lo mismo;
• el workflow debe estar activo para producción;
• hay que validar el payload;
• hay que responder rápido;
• hay que tratar duplicados;
• hay que proteger la URL.

Cuando llegues a ese punto, usa la guía de webhook en n8n paso a paso y seguro. No expongas un webhook público como primer experimento con datos reales.

Credenciales: no pegues secretos en nodos

Crea una credencial del tipo adecuado y asígnala al nodo. No escribas tokens dentro de Code, URLs, expresiones o JSON exportados. Limita permisos: una integración que solo lee contactos no necesita permiso para borrarlos.

Si una clave se ha incluido en una captura, repositorio o workflow compartido, trátala como expuesta y rótala. Ocultarla después no invalida las copias ya realizadas.

La documentación oficial de credenciales en n8n explica cómo se crean y reutilizan accesos sin pegarlos en cada nodo. Para empresa, esta parte no es un detalle técnico: es la diferencia entre una automatización mantenible y una colección de secretos repartidos por el editor.

Primer contacto con APIs

Muchas automatizaciones de empresa terminan llamando a una API. Una API es una forma estructurada de pedir o enviar datos a otro sistema. En n8n suele hacerse con nodos específicos de la herramienta o con HTTP Request.

Antes de conectar una API real, responde:

• qué endpoint vas a llamar;
• qué método usa: GET, POST, PUT, PATCH o DELETE;
• qué autenticación exige;
• qué campos son obligatorios;
• qué devuelve cuando sale bien;
• qué devuelve cuando falla;
• si tiene límite de peticiones;
• si repetir la llamada crea duplicados.

Para un primer workflow, evita DELETE y acciones irreversibles. Usa una consulta de prueba o una acción en entorno sandbox. Cuando el caso sea serio, sigue la guía de configurar una API en n8n paso a paso.

Errores normales al empezar

Activar antes de entender la salida

El editor muestra datos. Úsalos. Abre cada nodo, mira input y output, y confirma que el siguiente paso recibe lo que crees. No te fíes de que el nodo esté verde.

Usar datos reales para pruebas

Un cliente real no debe ser tu muestra de aprendizaje. Usa ejemplos anonimizados. Si necesitas una estructura real, copia la forma, no los datos.

Mezclar demasiadas herramientas

Formulario, CRM, WhatsApp, facturación, IA y email en el primer workflow es demasiado. Aprende con una entrada y una salida. Después añade una integración.

No pensar en duplicados

Los sistemas reintentan. Las personas hacen doble clic. Los webhooks se repiten. Si repetir una ejecución crea dos contactos, dos facturas o dos mensajes, el workflow todavía no está preparado.

Meter lógica crítica en Code sin documentar

El Code node es útil, pero puede esconder reglas que nadie entiende. Úsalo cuando aclare, no para convertir n8n en un archivo JavaScript gigante dentro de una caja.

No tener dueño

Un workflow sin responsable acaba abandonado. Alguien debe saber qué hace, dónde están las credenciales, cómo se desactiva y qué significa una alerta.

Cómo saber si tu primer workflow está bien hecho

Está bien hecho si una persona del equipo puede abrirlo y entender:

• qué entra;
• qué se valida;
• qué sistema se toca;
• qué pasa si falta un dato;
• qué pasa si se repite;
• dónde queda la evidencia;
• cómo se desactiva;
• quién recibe errores.

No hace falta que entienda cada expresión. Sí debe entender el proceso. Si el workflow parece una maraña, reduce alcance o separa subprocesos.

Ejemplo aplicado: lead de una empresa de servicios en Madrid

Una empresa recibe solicitudes desde una landing. El flujo inicial podría ser:

1. Webhook o formulario recibe solicitud.
2. Se normalizan campos: nombre, email, teléfono, servicio, zona.
3. Se valida que email y servicio existen.
4. Si falta algo, se crea una tarea interna.
5. Si está completo, se crea oportunidad en CRM.
6. Se avisa por email o canal interno.
7. Se registra event_id para evitar duplicados.
8. Se conserva solo la información necesaria.

Esto ya aporta valor sin responder automáticamente al cliente ni prometer nada. El equipo deja de copiar datos y gana velocidad, pero mantiene control comercial.

Ejemplo aplicado: factura o presupuesto

Para facturas y presupuestos, el primer workflow no debería emitir documentos definitivos sin revisión. Un alcance prudente:

1. Recibir solicitud aprobada.
2. Validar cliente, concepto, importe e impuestos.
3. Preparar borrador.
4. Avisar a la persona responsable.
5. Guardar evidencia.
6. No enviar al cliente hasta aprobación.

Tenemos una guía específica de automatizar facturas con Holded y n8n porque ahí importan idempotencia, estado del documento, PDF, permisos y revisión contable.

Ejemplo aplicado: WhatsApp

WhatsApp es atractivo porque el cliente lo usa, pero también es delicado. Un primer flujo puede:

• registrar la solicitud;
• clasificar intención;
• avisar al equipo;
• preparar una respuesta sugerida;
• no enviar nada sin revisión.

Más adelante se pueden automatizar respuestas frecuentes, siempre respetando consentimiento, plantillas, límites y salida humana. La guía de automatizar WhatsApp para empresas desarrolla ese caso.

Cómo documentar el workflow

Incluye una nota o documento con:

La documentación no es burocracia. Es lo que permite que el workflow siga vivo cuando cambie una persona, una API o una campaña.

Qué medir

Antes de automatizar, mide el proceso manual:

• frecuencia semanal;
• minutos por ejecución;
• errores habituales;
• tiempo hasta responder;
• personas implicadas;
• coste de corregir fallos.

Después mide:

• ejecuciones correctas;
• errores;
• tiempo ahorrado;
• duplicados evitados;
• solicitudes atendidas antes;
• tareas que llegan mejor clasificadas.

Sin medición, n8n se vende como juguete. Con medición, se convierte en mejora operativa.

Cómo importar una plantilla sin confiar a ciegas

En la biblioteca n8n de YAG puedes descargar dos ejemplos educativos. Antes de importarlos:

1. Abre el JSON en un editor de texto.
2. Busca http, webhook, code, executeCommand, credenciales y nodos comunitarios.
3. Importa en una instancia de pruebas.
4. Recorre todos los nodos y conexiones.
5. Sustituye rutas, IDs y datos de ejemplo.
6. Ejecuta casos válidos e inválidos.
7. Mantén el workflow inactivo hasta revisar efectos y permisos.

Qué plantilla sí descargaría

Descargaría plantillas educativas que muestren una idea pequeña: validar un lead, responder a un webhook, guardar un archivo, generar un resumen, preparar una tarea. No descargaría una plantilla enorme que promete "automatizar toda tu empresa" sin explicar credenciales, permisos, errores y datos.

Una buena plantilla:

• usa datos de ejemplo;
• no trae secretos;
• explica entradas y salidas;
• evita acciones irreversibles;
• tiene rama de error;
• es fácil de borrar;
• permite aprender una decisión concreta.

Una mala plantilla:

• pide tokens sin contexto;
• llama URLs desconocidas;
• incluye código opaco;
• escribe en sistemas reales;
• mezcla demasiados objetivos;
• no explica duplicados;
• no documenta límites.

Cuándo tu primer workflow deja de ser una prueba

Antes de producción debe tener propietario, criterio de éxito, alerta, respuesta ante duplicados y documentación de credenciales. En Workflow Settings puedes configurar el workflow de error y el guardado de ejecuciones. Guardarlo todo indefinidamente no es observabilidad: también puede convertirse en un problema de privacidad y almacenamiento.

El siguiente paso es instalar n8n con Docker y persistencia o, si ya tienes una instancia, aprender a conectar una API con n8n.

Ruta de aprendizaje recomendada

Si partes de cero, sigue este orden:

1. Entender items, nodos y ejecuciones con Manual Trigger.
2. Usar Edit Fields e If para validar datos.
3. Aprender expresiones básicas.
4. Crear un webhook en prueba.
5. Conectar una API de lectura.
6. Añadir una acción reversible.
7. Diseñar error workflow.
8. Pasar a Docker, backups y producción.

Ese orden evita saltar directamente a una automatización crítica. También te permite distinguir a un proveedor serio de alguien que solo importa plantillas.

Preguntas que haría antes de contratar n8n

Si vas a contratar una agencia n8n o un consultor, pregunta:

• qué proceso automatizarían primero y por qué;
• qué no automatizarían todavía;
• cómo evitan duplicados;
• cómo gestionan credenciales;
• qué pasa si una API cae;
• cómo documentan el workflow;
• qué parte queda en manos de una persona;
• cómo se mide el ahorro;
• qué precio tiene un flujo básico;
• qué soporte incluye.

La respuesta "lo conectamos todo" no basta. Lo que buscas es criterio, trazabilidad y control.

Checklist antes de activar

• He probado entradas correctas, incompletas y repetidas.
• Las credenciales no aparecen en nodos ni exportaciones.
• Sé qué sistema es la fuente de verdad de cada dato.
• El workflow no borra ni envía nada irreversible sin control.
• Existe una ruta de error y una persona responsable.
• La retención de ejecuciones coincide con la necesidad real.
• Puedo desactivar y recuperar el proceso.

CTA

Si quieres convertir un proceso manual en un flujo mantenible, en automatizaciones n8n para empresas revisamos primero el mapa, los riesgos y el coste de no automatizar. Un flujo básico puede empezar por una mejora concreta desde 99 euros cuando el alcance es pequeño y verificable; si el proceso necesita CRM, WhatsApp, facturación, APIs o IA, lo cerramos por escrito antes de tocar producción.

También puedes empezar por la guía de automatizaciones para empresas en Madrid para priorizar qué proceso merece la pena abordar primero.