Introducción

El editor de n8n es donde pasas la mayor parte del tiempo: construyendo, probando y depurando workflows de automatización. Antes de escribir cualquier lógica, necesitas sentirte cómodo con la interfaz. Esta lección te guía por cada área importante del editor e introduce los tres bloques de construcción de los que está hecho todo workflow de n8n: workflows, nodos y conexiones.

La interfaz del editor

Cuando abres n8n y creas un nuevo workflow, aterrizas en el canvas: una cuadrícula en blanco donde arrastras, sueltas y conectas elementos. La interfaz tiene varias áreas clave que debes conocer.

La barra superior contiene el nombre del workflow (haz clic para renombrarlo), el botón Save y el botón Execute Workflow, que ejecuta todo el workflow manualmente. En el extremo derecho tienes acceso a los ajustes del workflow y al menú de tu cuenta.

La barra lateral izquierda es tu panel de nodos. Haz clic en el ícono más o presiona Tab para abrirlo. Desde aquí buscas y añades nodos al canvas. Los nodos están agrupados por categoría: nodos trigger (los puntos de inicio), nodos de acción (los que hacen el trabajo) y nodos de utilidad (ayudantes de transformación de datos).

El propio canvas admite varios atajos de navegación que vale la pena aprender desde el principio. Desplázate para acercar y alejar. Mantén presionada la tecla Space y arrastra para hacer pan. Presiona Ctrl+Shift+F (o Cmd+Shift+F en Mac) para ajustar todo el workflow a la vista.

Workflows, nodos y conexiones

Toda automatización en n8n es un workflow: un documento guardado que contiene un grafo de nodos conectados entre sí. Un workflow puede estar activo (se ejecuta automáticamente al dispararse) o inactivo (solo se ejecuta cuando lo ejecutas manualmente).

Un nodo es una unidad de trabajo individual. Cada nodo tiene una tarea específica: obtener datos de una API, transformar un valor, enviar un correo electrónico, insertar una fila en una base de datos. Los nodos son los verbos de tu automatización. Cuando haces doble clic en un nodo, su panel de parámetros se abre en el lado derecho, donde configuras lo que hace.

Los nodos vienen en dos variedades. Los nodos trigger inician un workflow: escuchan un evento (una llamada webhook, una programación, una nueva fila en una hoja) y se disparan cuando ese evento ocurre. Cada workflow necesita exactamente un nodo trigger, y siempre se sitúa a la izquierda. Los nodos regulares hacen el trabajo real y se encadenan a partir del trigger.

Las conexiones son las flechas entre nodos. Transportan datos de un nodo al siguiente. Para dibujar una conexión, pasa el cursor sobre el borde derecho de un nodo hasta ver un círculo, luego arrastra al handle de entrada del siguiente nodo. El flujo de datos va de izquierda a derecha.

Trabajando con datos de nodos

n8n pasa datos entre nodos como un array de items. Cada item es un objeto JSON. Cuando un nodo se ejecuta, recibe items del nodo anterior, los procesa y genera nuevos items hacia el siguiente nodo.

Para ver qué datos produjo un nodo, haz clic en él después de una ejecución de prueba. El panel de salida muestra cada item como un objeto JSON formateado. Esta es tu herramienta principal de depuración: inspeccionas la salida de cada nodo para verificar que los datos se vean correctos antes de construir el siguiente paso.

Así se ve un item típico en el panel de salida:

{
  "id": 42,
  "name": "Alice",
  "email": "alice@example.com",
  "createdAt": "2024-01-15T10:30:00Z"
}

Para hacer referencia a un valor de un nodo anterior dentro de un campo de parámetro, n8n usa expresiones. Cambias un campo de texto estático a expresión haciendo clic en el interruptor de expresión (el pequeño ícono de signo igual junto al campo). Dentro de una expresión usas la siguiente sintaxis para extraer un valor:

{{ $json.email }}

Esto extrae el campo email del JSON del item actual. Usarás este patrón constantemente: es la forma principal en que los nodos se comunican entre sí.

Guardar y ejecutar

Guarda siempre tu workflow antes de ejecutarlo. Presiona Ctrl+S (o Cmd+S) o haz clic en el botón Save. Los cambios no guardados se muestran con un punto junto al nombre del workflow.

Para probar un workflow, haz clic en Execute Workflow en la barra superior. n8n ejecuta cada nodo desde el trigger en adelante y muestra una marca verde en cada nodo que tuvo éxito o una insignia roja de error en los que fallaron. Haz clic en un nodo fallido para leer el mensaje de error en su panel de salida.

Para nodos trigger que esperan eventos externos (como un nodo Webhook), n8n tiene un modo Test. Haz clic en Listen for Test Event en el nodo Webhook y luego dispara la petición desde tu sistema externo. n8n captura un payload real y te permite construir y probar el resto del workflow con esos datos sin esperar a otro evento real.

Resumen

El editor de n8n se construye alrededor de un canvas, una biblioteca de nodos y las conexiones entre ellos. Los workflows contienen la lógica de tu automatización. Los nodos trigger inician la ejecución. Los nodos regulares procesan datos. Las conexiones transportan items JSON de izquierda a derecha. El panel de salida después de cada ejecución de prueba es cómo verificas que todo funciona. Familiarízate haciendo clic, añadiendo nodos e inspeccionando salidas: el resto del curso se construye directamente sobre estas mecánicas.