n8n tutorial español: primer workflow y AI Agent

n8n es la plataforma open source de automatización de workflows con IA agéntica más popular en 2026. Permite conectar más de 400 servicios (Gmail, Slack, Notion, Airtable, OpenAI, Claude, Google Sheets, bases de datos) sin programar, mediante una interfaz visual de drag-and-drop. Self-hosted es completamente gratis e ilimitado; cloud tiene plan free con 100 ejecuciones/mes. Esta guía es un tutorial completo en español: instalación paso a paso, primer flujo, integración con LLMs y los mejores casos de uso reales.

¿Qué es n8n?

n8n (pronunciado «n-eight-n», abreviatura de «nodemation») es una plataforma de automatización de workflows open source creada por Jan Oberhauser en 2019. Su filosofía: poder construir cualquier integración entre servicios SaaS, APIs, bases de datos y modelos de IA mediante una interfaz visual de drag-and-drop, sin necesidad de programar (aunque permite código JavaScript/Python en nodos cuando lo necesites).

En 2026, n8n es la alternativa open source preferida a Zapier y Make entre developers, equipos técnicos y agencias. Sus diferenciadores clave: el código fuente es Apache 2.0 (puedes auditarlo), self-hosted es completamente gratis e ilimitado, y desde 2024 incorpora un AI Agent Node que permite construir agentes IA con memoria, herramientas y bucles agénticos sin escribir código.

Cuándo usar n8n vs Make o Zapier

Instalación paso a paso

Opción 1 · Docker (más simple, recomendado)

Si tienes Docker instalado, puedes lanzar n8n en 3 minutos:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Abre tu navegador en http://localhost:5678, crea cuenta admin y ya tienes n8n corriendo.

Opción 2 · Docker Compose con PostgreSQL (producción)

Para producción con persistencia y rendimiento:

version: "3.8"
services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: tucontraseña
      POSTGRES_DB: n8n
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
  n8n:
    image: docker.n8n.io/n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=tucontraseña
      - DB_POSTGRESDB_DATABASE=n8n
      - WEBHOOK_URL=https://tu-dominio.com/
    depends_on:
      - postgres
    volumes:
      - ./n8n-data:/home/node/.n8n

Opción 3 · npm (más simple para probar)

npm install -g n8n
n8n start

Requiere Node.js 18+. Ideal para desarrollo local.

Opción 4 · n8n Cloud (sin instalar nada)

Crea cuenta en n8n.io y elige plan Starter (free, 100 ejecuciones/mes) o Pro (30€/mes, 10.000 ejecuciones). Cero configuración técnica.

Interfaz: nodos, workflows y editor

n8n se basa en 3 conceptos:

• Nodo: bloque que representa una acción (enviar email, leer fila Sheets, llamar API, ejecutar código). Hay 400+ nodos nativos + nodo HTTP genérico universal.
• Workflow: conjunto de nodos conectados que define un flujo de automatización completo (ej: cuando llegue email, extraer datos, guardar en Notion y avisar por Slack).
• Editor visual: interfaz drag-and-drop donde diseñas workflows arrastrando nodos y conectándolos con líneas.

Los nodos pueden ser de 4 tipos: Triggers (inician el workflow: webhook, cron, evento), Apps (conectan con servicios como Gmail, Slack), Core (lógica: if/else, loop, transformar datos), y Code (ejecutar JavaScript o Python custom).

Tu primer workflow: monitorizar correos y avisar por Telegram

Vamos a crear un workflow real práctico: cuando llegue un email a Gmail con asunto «Urgente», enviar mensaje por Telegram con resumen.

1. Crea workflow nuevo en el panel principal
2. Añade nodo trigger Gmail «On New Email»: conecta tu cuenta Google con OAuth
3. Filtra por asunto: en parámetros del nodo, añade filtro subject:Urgente
4. Añade nodo «Set»: para extraer remitente, asunto y primeras 200 palabras del body
5. Añade nodo Telegram «Send Message»: conecta tu bot de Telegram (BotFather) y configura chat_id
6. Compón mensaje: usa expresiones n8n {{$json["from"]}} envió: {{$json["subject"]}}
7. Activa el workflow con el toggle superior derecho

Listo. Cada vez que recibas email «Urgente» recibirás aviso instantáneo en Telegram.

AI Agent Node: crear agentes con n8n

Desde 2024, n8n incorpora el nodo AI Agent (basado en LangChain.js) que permite construir agentes IA con razonamiento, memoria conversacional, herramientas (tools) y bucles agénticos sin escribir código:

1. Añade nodo AI Agent al workflow
2. Conecta un Chat Model: OpenAI GPT-5, Anthropic Claude Sonnet 4.6, Ollama local, Groq, etc.
3. Conecta una Memory: Buffer simple, Vector Store (Pinecone, Weaviate, Qdrant), Postgres
4. Añade Tools: calculadora, navegador web, ejecución código, lectura/escritura archivos, llamadas HTTP, cualquier nodo n8n como tool
5. Define el system prompt: «Eres un agente que ayuda a… usando estas herramientas…»
6. Trigger del agente: chat trigger (interfaz web), webhook, schedule, evento

El agente decide por sí solo qué tool usar en cada paso, mantiene contexto y se autocorrige hasta cumplir el objetivo. Es comparable a CrewAI o LangGraph pero sin escribir código Python.

Integraciones con LLMs en n8n 2026

10 casos de uso reales de n8n en español 2026

1. Clasificador de emails: recibe Gmail, IA clasifica (urgente/spam/cliente/proveedor), enruta a Slack/Notion/CRM
2. Resumen diario noticias: RSS feeds → Claude resume → email/Telegram cada mañana
3. Generación contenido SEO: Airtable con keywords → Claude genera artículo → publica WordPress vía REST API
4. Atención al cliente WhatsApp: WhatsApp Business → AI Agent con base de conocimiento → responde o escalar a humano
5. Análisis CV recibidos: Email con adjunto CV → extrae texto PDF → Claude evalúa contra job description → guarda en Sheets con score
6. Monitorización precios competencia: scraping HTTP cada hora → comparar precios → alertar Telegram si baja precio competidor
7. Sincronización CRM: nuevo lead Typeform → crea contacto HubSpot + crear deal Pipedrive + tarea Notion
8. Generación facturas automática: nuevo pedido Stripe → crear factura PDF → enviar email cliente + guardar Drive
9. Newsletter automática: productos Shopify nuevos → Claude redacta email → envía MailChimp segmentado
10. Asistente meeting Zoom: graba meeting → transcribe Whisper → Claude genera resumen + tareas → envía Notion + Slack

Errores frecuentes al empezar con n8n

1. No usar credenciales OAuth correctamente: cada servicio (Gmail, Slack) requiere configuración OAuth la primera vez. Sigue la documentación oficial paso a paso.
2. No probar con datos reales: el botón «Execute Node» ejecuta cada paso individualmente para depurar antes de activar workflow completo.
3. Confundir Test workflow vs Production: los webhooks de «Test» solo están activos cuando el editor está abierto. Para producción real, «Activate» el workflow.
4. Olvidar configurar variables de entorno: en producción usa variables (claves API, contraseñas) en lugar de hardcodearlas en nodos.
5. No usar Error Workflow: configura un workflow de error global que te avise si algún workflow falla en producción.
6. Self-hosted sin HTTPS: webhooks externos requieren HTTPS. Configura nginx/Caddy o usa Traefik con Let’s Encrypt.
7. No respetar rate limits: servicios como OpenAI, Gmail tienen límites. Usa nodos «Wait» entre llamadas o nodo «Loop Over Items» con throttle.

Preguntas frecuentes n8n tutorial español 2026

Fuentes y comunidad

1. n8n – Documentación oficial — docs.n8n.io
2. n8n GitHub repo — github.com/n8n-io
3. n8n Community Forum — community.n8n.io
4. Templates oficiales — n8n.io/workflows (más de 1.500 plantillas)