Cheatsheet de Automatización con n8n: Nodos Principales, Expresiones, Credenciales y Flujos de Error

Referencia rápida de n8n: los nodos principales que aparecen en todo flujo, la sintaxis de expresiones con {{ }}, cómo fluyen los datos y las credenciales, y la gestión de errores que mantiene vivas las automatizaciones.

🧪

Ejecuta y Edita este Código en Vivo Sin instalaciones locales. Soporta Python 3, JS y SQL.

▶ Probar en Playground →

1. Nodos principales que usarás en todo flujo

Un flujo es disparadores más transformaciones más acciones. Estos doce nodos cubren la mayoría de las automatizaciones reales; apréndelos primero.

Nodo	Papel en el flujo
`Manual Trigger`	Arranca con un clic: para pruebas y ejecuciones puntuales
`Schedule Trigger`	Ejecuta con un horario tipo cron (cada hora, entre semana a las 9:00…)
`Webhook`	Arranca con una petición HTTP a tu URL única; puede responder en síncrono
`HTTP Request`	Llama a cualquier API: método, URL, cabeceras, cuerpo, autenticación
`Code`	Transforma elementos con JavaScript (modo habitual: Run Once for All Items)
`Edit Fields (Set)`	Construye o remodela el JSON de cada elemento
`IF`	Ramifica según una condición: ruta true y ruta false
`Switch`	Dirige los elementos a una de varias salidas según su valor
`Split Out`	Convierte un elemento con un campo array en muchos elementos
`Merge`	Combina dos ramas en un solo flujo de elementos
`Wait`	Pausa la ejecución (se reanuda tras un tiempo o una llamada webhook)

2. Expresiones: en {{ }} se mueve el dato

Cualquier campo puede contener una expresión entre llaves dobles que lee el JSON entrante y nodos anteriores por nombre.

CODE SNIPPET

// Datos del elemento actual
{{ $json.email }}                    // campo del elemento entrante
{{ $json.body.customer.name }}      // campo anidado (el payload del webhook va bajo body)

// Nodo anterior, por nombre exacto
{{ $('HTTP Request').item.json.id }}      // elemento emparejado
{{ $('HTTP Request').first().json.token }} // primer elemento
{{ $('HTTP Request').all() }}              // todos los elementos

// Fechas y entorno (Luxon por debajo)
{{ $now.toISO() }}                        // marca de tiempo actual
{{ $now.minus({ days: 7 }).toFormat('yyyy-MM-dd') }}
{{ $env.API_BASE_URL }}                    // variable de entorno

// En el nodo Code, los mismos datos en JavaScript
return items.map(item => ({ json: { ...item.json, seen: true } }));

3. Flujo de datos y credenciales

Dos ideas evitan casi todos los dolores de principiante: elementos enlazados entre nodos (emparejados) y secretos en credenciales referenciadas, nunca en los campos.

Los elementos son la unidad de datos. Casi todo nodo se ejecuta una vez por elemento: 50 entrantes, 50 ejecuciones.
Los emparejados mantienen la cadena trazable. Una expresión que apunta atrás sigue el emparejamiento hasta su elemento; déjalo por defecto salvo cambio consciente a .first() o .all().
Crea las credenciales una vez y reutilízalas. Ajustes → Credenciales guarda claves y OAuth cifrados; los nodos eligen por nombre.
OAuth2, lo habitual en Google o Slack: crea la credencial, Connect, aprueba en el navegador.
Fija datos mientras construyes. Fijar (pin) la salida congela datos de ejemplo para editar los nodos siguientes sin repetir llamadas.

4. Flujos de error: automatizaciones que sobreviven

Todo flujo en producción necesita una ruta de fallo: configúrala una vez y añade reintentos en el nodo inestable.

Ajustes del flujo → Error Workflow: apunta a un flujo de error dedicado (empieza con Error Trigger; recibe flujo, nodo y mensaje): avisa por Slack o correo.
Ajustes del nodo → Retry On Fail: reintenta varias veces con espera entre intentos; para límites de tasa y APIs inestables.
Ajustes del nodo → On Error → Continue: la ejecución sigue y el fallo se gestiona después comprobando $json.error en un nodo IF.
Nodo Stop And Error: fallo deliberado y legible con datos inválidos, en vez de una rotura críptica posterior.
La vista de ejecuciones es tu registro: cada ejecución conserva sus datos para inspeccionar y reejecutar desde el fallo.