n8n tutorial: automatización sin código paso a paso

A diferencia de Zapier o Make, n8n es open source y puedes instalarlo en tu propio servidor. Eso significa control total sobre tus datos y sin límites artificiales en ejecuciones.

En esta guía vas a aprender desde la instalación hasta la creación de workflows con inteligencia artificial, pasando por los errores más comunes y una comparativa honesta con las alternativas. Si ya sabes cómo automatizar tu trabajo con IA pero necesitas la herramienta concreta, n8n es probablemente tu mejor opción.

Instalación y primeros pasos

Tienes tres formas de empezar con n8n, ordenadas de más rápida a más robusta.

Opción 1: Docker (recomendada para probar)

La forma más rápida de tener n8n funcionando en tu máquina:

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

# Acceder en el navegador
# http://localhost:5678

Con este comando tienes n8n corriendo en menos de 2 minutos. Los datos se persisten en el volumen n8n_data, así que puedes parar y reiniciar sin perder tus workflows.

Opción 2: Docker Compose (recomendada para producción)

Para producción necesitas PostgreSQL como base de datos (en lugar de SQLite, que es el default). Crea un archivo docker-compose.yml:

version: '3.8'
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=tu_password_seguro
      - N8N_ENCRYPTION_KEY=clave_cifrado_unica
      - WEBHOOK_URL=https://tu-dominio.com/
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:16
    environment:
      - POSTGRES_DB=n8n
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=tu_password_seguro
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:

Levántalo con docker compose up -d. La variable N8N_ENCRYPTION_KEY es importante: cifra las credenciales almacenadas. No la pierdas o no podrás recuperar las credenciales guardadas.

Opción 3: n8n Cloud

Si prefieres no gestionar servidores, n8n Cloud ofrece hosting gestionado desde 20 EUR/mes. Incluye actualizaciones automáticas, backups y soporte. Es la opción más rápida para equipos que quieren ir directo a construir workflows sin tocar infraestructura.

Configuración inicial

Al abrir n8n por primera vez, crea tu cuenta de administrador. Después, lo primero que deberías hacer:

1. Configurar credenciales: Ve a Settings > Credentials y añade las APIs que vas a usar (Gmail, Slack, OpenAI, etc.)
2. Activar ejecuciones en background: En Settings > Workflow Settings, activa "Save execution progress" para poder depurar workflows que fallen
3. Explorar templates: n8n tiene una biblioteca de 900+ templates listos para usar. No reinventes la rueda.

Conceptos básicos

Antes de construir tu primer workflow, necesitas entender seis conceptos clave:

• Workflow: un flujo de trabajo completo, de inicio a fin. Piensa en ello como una receta con pasos encadenados
• Nodo: cada paso del workflow (trigger, acción, transformación). Un workflow típico tiene entre 3 y 15 nodos
• Trigger: el evento que inicia el workflow (webhook, cron, email recibido, nuevo registro en DB)
• Conexión: la línea que une dos nodos y pasa datos entre ellos. Un nodo puede conectar con varios nodos siguientes
• Ejecución: cada vez que un workflow se ejecuta de principio a fin. Puedes ver el historial completo con los datos de cada paso
• Credencial: los datos de acceso a servicios externos (API keys, OAuth tokens). Se almacenan cifrados

Tu primer workflow

Vamos a crear un workflow sencillo: recibir un webhook, procesar los datos y enviar un email.

Paso 1: Crear el trigger

Abre n8n, haz clic en "Add first step" y selecciona Webhook. Esto genera una URL única que, cuando recibe una petición HTTP, inicia el workflow.

Paso 2: Procesar datos

Conecta un nodo Set para transformar los datos recibidos. Por ejemplo, extraer el nombre y email del JSON del webhook.

Paso 3: Enviar email

Conecta un nodo Send Email (SMTP o servicio como Gmail). Usa las variables del paso anterior para personalizar el contenido.

Paso 4: Activar

Haz clic en "Active" para que el workflow esté escuchando. Cualquier petición al webhook ahora dispara el flujo completo.

En menos de 10 minutos tienes un endpoint funcional que procesa datos y envía emails. Sin escribir una sola línea de código.

Nodos esenciales

n8n tiene 400+ integraciones. Estos son los nodos que usarás en el 80% de tus workflows:

• Webhook: recibir peticiones HTTP externas
• Schedule Trigger: ejecutar en intervalos (cada hora, cada día)
• HTTP Request: llamar a cualquier API REST
• Code: ejecutar JavaScript o Python personalizado
• IF: bifurcar el flujo según condiciones
• Switch: múltiples ramificaciones según el valor de un campo
• Set: crear o transformar datos
• Merge: combinar datos de múltiples ramas
• Gmail/SMTP: enviar y recibir emails
• Slack: enviar mensajes y notificaciones
• Postgres/MySQL: operaciones de base de datos
• Supabase: operaciones CRUD con autenticación integrada

n8n vs Zapier vs Make: cuándo elegir n8n

La pregunta más frecuente antes de invertir tiempo en n8n. Aquí va una comparativa honesta basada en uso real (lee la comparativa completa para más detalle).

Elige n8n si necesitas workflows complejos con ramificaciones, quieres integrar IA de forma seria, manejas datos sensibles que no deben salir de tu infraestructura, o tus automatizaciones van a escalar en número de ejecuciones. Elige Zapier si necesitas algo funcionando en 5 minutos sin complicaciones técnicas. Elige Make si tu presupuesto es muy ajustado y los workflows son relativamente simples.

5 workflows con IA que puedes crear hoy

Estos son los workflows con inteligencia artificial más útiles que puedes montar en n8n en menos de una hora cada uno. Los ordeno por complejidad creciente.

1. Clasificador de emails

Trigger: IMAP (email recibido). Proceso: el nodo OpenAI o Anthropic clasifica el email en categorías (soporte, ventas, spam, urgente). Según la categoría, el nodo IF lo enruta: soporte va a un ticket en tu helpdesk, ventas a tu CRM, spam se archiva.

Tiempo de setup: 20 minutos. Ahorro: 30 minutos diarios si recibes más de 50 emails. Conecta esto con automatización de email con IA para ir más lejos.

2. Pipeline de contenido

Trigger: nuevo registro en Airtable o Google Sheets (un tema propuesto). Proceso: el LLM genera un borrador, otro nodo genera una imagen con DALL-E, un tercero programa la publicación en redes sociales. El resultado final se guarda en una carpeta de revisión.

Tiempo de setup: 30 minutos. Ideal si publicas contenido regularmente y quieres automatizar redes sociales con IA.

3. Enriquecimiento de leads

Trigger: webhook desde tu formulario de contacto. Proceso: el nodo HTTP Request consulta APIs de enriquecimiento (Clearbit, Apollo) para obtener datos de la empresa. El LLM analiza la información y genera un scoring del lead. El resultado se guarda en tu CRM con una nota personalizada.

Tiempo de setup: 40 minutos. Especialmente útil para equipos de ventas B2B.

4. Resumen de reuniones

Trigger: Schedule (cada hora) o webhook desde tu herramienta de grabación. Proceso: el nodo Whisper (OpenAI) transcribe el audio. El LLM genera un resumen con puntos clave, tareas asignadas y decisiones tomadas. Se envía por Slack al canal del equipo y se guarda en Notion.

Tiempo de setup: 35 minutos. Ahorra horas semanales de notas manuales.

5. Procesador de facturas

Trigger: email recibido con adjunto PDF. Proceso: el nodo extrae el PDF, lo envía al LLM con un prompt que pide extraer campos estructurados (emisor, CIF, importe, fecha, concepto). Los datos se validan con un nodo Code y se insertan en tu base de datos PostgreSQL o Supabase.

Tiempo de setup: 45 minutos. Relevante si necesitas automatizar facturación con IA.

Conectar n8n con LLMs

n8n tiene tres formas principales de integrar modelos de lenguaje en tus workflows.

Nodo OpenAI (el más directo)

n8n incluye un nodo nativo de OpenAI. Configuras tu API key en credenciales, seleccionas el modelo (GPT-4o, GPT-4 Turbo) y escribes tu prompt. Soporta chat completions, embeddings e imágenes con DALL-E.

// Ejemplo de configuración del nodo OpenAI
// Model: gpt-4o
// Messages:
//   System: "Eres un asistente que clasifica emails en: soporte, ventas, spam"
//   User: {{ $json.emailBody }}
// Temperature: 0.3
// Max tokens: 200

HTTP Request para Claude API

Para usar Claude u otros LLMs sin nodo nativo, usa el nodo HTTP Request. Configura la petición POST a la API de Anthropic:

// Nodo HTTP Request
// Method: POST
// URL: https://api.anthropic.com/v1/messages
// Headers:
//   x-api-key: {{ $credentials.anthropicApi.apiKey }}
//   anthropic-version: 2023-06-01
//   content-type: application/json
// Body (JSON):
{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "{{ $json.texto }}"}
  ]
}

Este patrón funciona para cualquier API de LLM: Mistral, Groq, Together AI, o incluso tu propio endpoint de vLLM u Ollama. Si te interesa profundizar en las posibilidades de Claude, lee qué es Claude Code y cómo usarlo.

Nodo AI Agent (el más potente)

El nodo AI Agent es la forma más avanzada de usar IA en n8n. Combina un LLM con herramientas (tools) y memoria. Puedes darle acceso a otros nodos de n8n y dejar que el modelo decida cuándo usarlos.

Por ejemplo: un AI Agent con acceso a un nodo de búsqueda web, un nodo de base de datos y un nodo de email. Le dices "investiga sobre esta empresa y envía un resumen al equipo". El agente decide qué herramientas usar y en qué orden.

Self-hosting vs Cloud

Esta es una decisión importante que afecta al coste, la privacidad y el mantenimiento a largo plazo.

Self-hosting: control total

• Coste: desde 5 EUR/mes en un VPS (Hetzner, Contabo). Sin límite de ejecuciones ni workflows
• Privacidad: tus datos y credenciales nunca salen de tu servidor. Esencial si manejas datos regulados (RGPD, ENS)
• Flexibilidad: puedes instalar paquetes npm adicionales en el nodo Code, configurar variables de entorno a tu gusto, montar reverse proxies
• Mantenimiento: actualizaciones manuales, backups bajo tu responsabilidad, troubleshooting si algo falla a las 3am

n8n Cloud: rapidez y tranquilidad

• Coste: desde 20 EUR/mes (Starter). El plan Pro (50 EUR/mes) incluye más ejecuciones y usuarios
• Ventajas: actualizaciones automáticas, backups diarios, soporte por email, sin configurar infraestructura
• Limitaciones: no puedes instalar paquetes npm custom, dependes de la disponibilidad del servicio, límite de ejecuciones según plan

Recomendación

Para empezar: n8n Cloud o Docker local. Para producción con menos de 10 workflows simples: n8n Cloud Pro. Para producción con muchos workflows, IA intensiva o datos sensibles: self-hosting con Docker Compose y PostgreSQL en un VPS europeo.

Errores comunes con n8n

Después de construir más de 50 workflows, estos son los 5 errores que veo con más frecuencia.

1. No manejar errores en el workflow

El error más grave. Si un nodo falla (API caída, dato malformado), todo el workflow se detiene silenciosamente. Solución: usa el nodo Error Trigger para capturar fallos y enviar alertas. Configura reintentos automáticos en los nodos HTTP Request (Settings > Retry on Fail).

2. Guardar credenciales en nodos Code

Nunca pongas API keys directamente en el código de un nodo Code o en expresiones. Usa siempre el sistema de Credentials de n8n, que cifra los datos en reposo. Si hardcodeas una clave y exportas el workflow, la clave se va con él.

3. No usar sub-workflows

Cuándo un workflow supera los 20 nodos, se vuelve imposible de depurar. Divide la lógica en sub-workflows que se llaman entre sí con el nodo Execute Workflow. Cada sub-workflow hace una cosa y se testea por separado.

4. Ignorar los límites de memoria

n8n carga todos los datos de una ejecución en memoria. Si procesas un CSV de 100MB o haces una query que devuelve 500.000 filas, el proceso se cae. Solución: página tus datos, procesa en lotes con el nodo Loop Over Items, y filtra en origen (en la query SQL, no después).

5. No versionar workflows

n8n no tiene un sistema de versionado integrado robusto. Si cambias un workflow en producción y algo se rompe, no hay "undo" fácil. Exporta tus workflows como JSON y guárdalos en Git. Hazlo al menos antes de cada cambio significativo.

Recursos para aprender más

n8n tiene una comunidad activa y en crecimiento. Estos son los recursos que realmente me han servido:

• Documentación oficial: completa y con ejemplos. Empieza por la sección "Courses" dentro de la documentación
• Comunidad n8n: foro oficial donde puedes buscar problemas específicos. La mayoría de errores que encuentres ya tienen solución aquí
• Biblioteca de templates: 900+ workflows listos para importar y modificar. No construyas desde cero si existe un template similar
• Canal de YouTube de n8n: tutoriales en vídeo para workflows específicos. Especialmente útiles los de integraciones con IA
• Nuestro curso de automatización con IA: incluye un módulo completo de n8n con ejercicios prácticos y proyectos reales

Preguntas frecuentes

Siguiente paso

n8n es la base para construir automatizaciones complejas con IA. Si aún no decidiste plataforma, lee la comparativa Zapier vs Make vs n8n para tomar una decisión informada. Si ya estás listo para empezar, el clasificador de emails es el workflow perfecto para tu primera hora con n8n.

Para profundizar en automatización con inteligencia artificial, explora cómo automatizar email con IA o descubre las mejores herramientas de IA para productividad. Y si quieres combinar n8n con desarrollo asistido por IA, echa un vistazo a qué es Claude Code para ver cómo ambas herramientas se complementan.