Introducción

n8n (se pronuncia "n-eight-n" o simplemente "nodemation") es una herramienta de automatización de workflows de código abierto que te permite conectar diferentes servicios y APIs mediante un editor visual basado en nodos. En lugar de escribir código de pegamento manualmente, arrastras nodos a un lienzo, los configuras y dibujas conexiones para definir cómo fluyen los datos de un paso al siguiente.

n8n se distingue de herramientas como Zapier o Make en un aspecto clave: es de código fuente disponible y se puede auto-hospedar (self-host). Puedes ejecutarlo en tu propio servidor, lo que significa que tus datos nunca salen de tu infraestructura y no hay niveles de precios por tarea. La contrapartida es que tú eres responsable de hospedarlo y mantenerlo, aunque n8n también ofrece una opción de nube hospedada si prefieres no gestionar la infraestructura.

Internamente, cada workflow de n8n es fundamentalmente solo JSON. El editor visual es una capa amigable sobre ese JSON, razón por la cual n8n resulta muy cómodo para desarrolladores que quieran echar un vistazo bajo el capó.

Navegando por el editor visual

Cuando abres n8n, las áreas principales con las que interactuarás son:

- El lienzo en el centro, donde construyes tu workflow añadiendo y conectando nodos. - La barra lateral izquierda con la paleta de nodos, organizada en categorías como nodos trigger, nodos regulares de aplicación/acción y nodos auxiliares (como Code, IF, Set, Merge). - La barra de herramientas superior con opciones para guardar, ejecutar, activar y compartir el workflow. - El panel lateral derecho del nodo que se abre al hacer clic en un nodo, donde configuras sus parámetros y credenciales.

Un workflow siempre comienza con un nodo trigger, algo que inicia la ejecución cuando ocurre un evento (por ejemplo, un webhook que recibe una petición HTTP, una programación que se activa en un horario cron, o una nueva fila que aparece en una base de datos).

# Quick install via npm (requires Node.js 18+)
npx n8n

# Or with Docker
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Después de cualquiera de los comandos, abre http://localhost:5678 en tu navegador y verás el editor.

Anatomía de un nodo

Cada nodo representa una única acción: obtener datos, transformar datos, llamar a una API, ramificar según una condición, etc. La mayoría de los nodos tienen tres pestañas:

- Parameters: las entradas que configuras (URL, query string, mapeo de campos). - Settings: opciones a nivel de nodo como el comportamiento de reintentos, el manejo de errores y si se debe continuar tras un fallo. - Documentation: una breve referencia extraída de la documentación del nodo, para que no tengas que salir del lienzo.

Los datos fluyen entre los nodos a través del cable que dibujas. Por defecto, esta es la salida principal y la forma de los datos producidos es el mismo objeto JSON que obtendrías si llamaras a la API subyacente directamente. Puedes renombrar un nodo, añadirle notas y deshabilitarlo sin eliminarlo, lo cual resulta muy útil al depurar.

{
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "my-webhook"
      },
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1,
      "position": [240, 300]
    }
  ],
  "connections": {}
}

El fragmento anterior es el JSON de un único nodo trigger Webhook exportado desde n8n. Fíjate en lo legible que es: el método HTTP, la ruta y la posición del nodo en el lienzo son propiedades JSON planas. Esto es lo que permite que los workflows se controlen por versiones y se generen de forma programática.

Panel de ejecuciones y depuración

Una vez guardado tu workflow, haz clic en "Execute workflow" (o "Execute node" en un único nodo) para ejecutarlo. n8n registra cada ejecución en el panel Executions. Al hacer clic en una ejecución pasada puedes inspeccionar los datos de entrada y salida de cada nodo paso a paso, lo cual es la forma más rápida de depurar un workflow roto.

Si un nodo falla, la ejecución se marca como "error" y el panel te muestra qué nodo lanzó el error, cuál fue el mensaje de error y los datos que recibió ese nodo. Un error común al principio es asumir que los datos existen en un nodo cuando no es así: abre siempre la ejecución y observa el JSON real en cada paso antes de asumir.

Otros dos paneles que conviene conocer: la pestaña Credentials (donde guardas las API keys una vez y las referencias desde muchos nodos) y la pestaña Variables (para almacenar valores reutilizables como URLs o nombres de entorno sin hardcodearlos en cada nodo).

Resumen

n8n te ofrece un editor visual para construir flujos de datos que conectan APIs, bases de datos y lógica personalizada, sin renunciar a la posibilidad de saltar a código, versionar JSON o auto-hospedar. Las áreas principales que debes aprender son el lienzo, la paleta de nodos, el panel de configuración de cada nodo y el panel Executions, utilizado para depurar. Cada workflow comienza con un nodo trigger, y los datos de cada nodo son JSON plano que puedes inspeccionar en cualquier punto de la ejecución.