n8n: automatización total con workflows y agentes

n8n ocupa un lugar útil entre una herramienta visual y un entorno de programación. Permite que una persona de operaciones entienda el recorrido de los datos y, al mismo tiempo, deja a un perfil técnico llamar a una API, transformar JSON, consultar una base de datos o ejecutar código cuando los nodos estándar no bastan. Esa combinación evita dos extremos: procesos manuales que dependen de memoria humana y aplicaciones a medida demasiado costosas para una automatización sencilla.

Por qué elegir n8n

La ventaja principal es el control. Puedes ejecutar n8n en tu infraestructura, decidir dónde viven las credenciales, observar cada ejecución y exportar los workflows. El editor visual muestra la secuencia real: qué inicia el flujo, qué condiciones separan las ramas y qué sistema recibe el resultado. Esto facilita revisar un proceso con negocio sin ocultar su complejidad técnica.

También es una buena opción cuando un proceso mezcla servicios con formatos distintos. Un webhook puede entregar JSON, una hoja de cálculo puede devolver filas, un correo puede incluir adjuntos y una API puede paginar resultados. n8n convierte esas entradas en ítems y ofrece nodos para filtrarlos, agruparlos o transformarlos. Cuando falta una integración, el nodo HTTP Request suele ser suficiente.

Instalación con Docker Compose

Para un despliegue controlado, define la imagen mediante una variable. No uses una versión supuestamente «actual» copiada de una guía: selecciona una etiqueta o un digest que hayas probado y guarda esa referencia en el entorno. El siguiente Compose usa PostgreSQL, persistencia y una clave de cifrado proporcionada fuera del archivo.

services:
  n8n:
    image: ${N8N_IMAGE}
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_DATABASE: n8n
      DB_POSTGRESDB_USER: n8n
      DB_POSTGRESDB_PASSWORD: ${N8N_DB_PASSWORD}
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
      N8N_HOST: ${N8N_HOST}
      N8N_PROTOCOL: https
      WEBHOOK_URL: https://${N8N_HOST}/
      GENERIC_TIMEZONE: Europe/Madrid
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: ${POSTGRES_IMAGE}
    restart: unless-stopped
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: ${N8N_DB_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n -d n8n"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  n8n_data:
  postgres_data:

Coloca un proxy inverso con HTTPS delante del servicio y no publiques el puerto directamente en Internet; el enlace a 127.0.0.1 lo limita al host. Protege el archivo de secretos, conserva la misma N8N_ENCRYPTION_KEY y respalda tanto PostgreSQL como el volumen de n8n. Antes de actualizar, revisa las notas de la versión elegida, prueba una copia y verifica los workflows críticos.

Workflows, nodos, ítems y triggers

Un workflow es el proceso completo. Un nodo es una operación: leer, transformar, decidir o escribir. Un trigger es el nodo que inicia la ejecución, ya sea por horario, webhook o evento externo. Los ítems son las unidades que viajan entre nodos; cada una contiene habitualmente un objeto JSON y, si hace falta, datos binarios.

Comprender los ítems evita muchos errores. Si un trigger produce veinte ítems, el siguiente nodo puede ejecutarse para cada uno. Un filtro puede reducirlos; un agregado puede combinarlos; un bucle puede procesarlos por lotes. No asumas que una salida es «un documento»: inspecciona siempre la forma del JSON y decide si trabajas por ítem o con el conjunto.

{
  "event_id": "evt_7f2a",
  "customer": {"email": "[email protected]"},
  "status": "paid"
}

Expresión para el correo:
{{ $json.customer.email }}

Diez workflows esenciales

Empieza por procesos con entrada clara, resultado comprobable y propietario definido. Estos diez patrones son más valiosos como esqueletos adaptables que como recetas para copiar sin revisar.

1. Formulario a CRM. Webhook → validación → búsqueda por email → creación o actualización. Rechaza campos incompletos y responde con un estado inequívoco.
2. Lead magnet por correo. Webhook → consentimiento → alta del contacto → envío transaccional. Guarda la fuente y no suscribas a marketing sin base válida.
3. Informe operativo diario. Schedule Trigger → consulta de solo lectura → agregación → correo o Telegram. Si no hay datos, envía un mensaje explícito en vez de aparentar un fallo.
4. Incidencia desde soporte. Trigger de correo → extracción → clasificación → creación del ticket → confirmación. La IA propone prioridad; una regla objetiva decide qué se escala.
5. Pago a activación. Webhook firmado → deduplicación por identificador → actualización del acceso → bienvenida. Nunca confíes solo en campos enviados por el navegador.
6. RSS a borrador editorial. Schedule Trigger → RSS → filtrado → resumen → documento en estado borrador. Una persona revisa fuentes, tono y derechos antes de publicar.
7. Monitor de servicio. Schedule Trigger → petición de salud → condición → alerta. Incluye servicio, hora, respuesta y enlace al procedimiento de recuperación.
8. Sincronización entre bases. Schedule Trigger → lectura incremental → normalización → upsert. Usa una marca temporal y una clave estable para reanudar sin duplicados.
9. Revisión de repositorio. Trigger de Git → selección de evento → resumen → aviso al canal del equipo. Evita enviar código sensible a modelos externos.
10. Gestor global de errores. Error Trigger → extracción de contexto → registro → alerta. Agrupa repeticiones para que una tormenta de fallos no oculte la causa inicial.

Agentes acotados y aprobación humana

Un workflow tradicional conoce su siguiente paso. Un agente recibe un objetivo, contexto y herramientas, y puede decidir cuál utilizar. Esa flexibilidad es útil para clasificar solicitudes, recopilar información o preparar una propuesta, pero amplía el espacio de error. Por eso el agente debe ser acotado: pocas herramientas, instrucciones concretas, datos mínimos y un número máximo de pasos.

Separa estrategia y ejecución. El modelo puede decidir «preparar una respuesta» o «proponer una actualización», pero un nodo determinista valida el esquema, los permisos y las reglas de negocio. Para acciones de impacto, guarda la propuesta con estado pending_approval, notifica a la persona responsable y espera un webhook de aprobación. Solo la rama aprobada ejecuta el envío o la modificación.

Trigger → cargar contexto mínimo → agente propone acción
        → validar salida estructurada
        → guardar pending_approval
        → aprobación humana
          ├─ aprobar → ejecutar herramienta permitida → registrar resultado
          └─ rechazar → cerrar sin efectos → registrar motivo

No entregues al agente una credencial administrativa si solo necesita crear borradores. Limita colecciones, tablas, destinatarios y operaciones. Establece tiempo máximo, tamaño de contexto y salida JSON validable. Registra la petición, la propuesta, la decisión humana y el efecto final para poder reconstruir lo ocurrido.

Gestión segura de credenciales

Las credenciales no deben aparecer en expresiones, nodos Code, exportaciones ni capturas. Usa el almacén de credenciales de n8n y mantén estable la clave de cifrado. Los secretos del despliegue deben proceder de un gestor de secretos o del entorno, con acceso restringido. Separa desarrollo, pruebas y producción: compartir claves convierte una prueba inocente en una operación real.

• Concede permisos mínimos: lectura si el flujo solo consulta; escritura limitada si actualiza.
• Usa cuentas de servicio identificables, no la cuenta personal de un empleado.
• Rota una credencial cuando cambie su exposición o responsable y comprueba los workflows dependientes.
• No guardes payloads sensibles por defecto; decide qué datos requiere la depuración y durante cuánto tiempo.
• Verifica firmas de webhooks cuando el proveedor las ofrezca y compara secretos de forma segura.

Error handling e idempotencia

Un workflow fiable parte de que las redes fallan, las APIs limitan solicitudes y los eventos pueden llegar más de una vez. Los reintentos sirven para errores transitorios, no para datos inválidos ni permisos insuficientes. Aplica espera creciente y un límite; después, envía el ítem a una cola de revisión o registra un estado recuperable. Una alerta útil incluye workflow, nodo, ejecución, tipo de error y acción recomendada.

La idempotencia garantiza que repetir una entrada no repita el efecto. Antes de procesar un webhook, registra su identificador en una tabla con restricción única. Si ya existe, responde correctamente sin volver a enviar el correo, crear el pedido o conceder acceso. Para escrituras, prefiere upsert con una clave de negocio estable. Para trabajos largos, persiste estados como received, processing, completed y failed.

BEGIN;
INSERT INTO processed_events (event_id, received_at)
VALUES (:event_id, NOW())
ON CONFLICT (event_id) DO NOTHING;
-- Continuar solo si se insertó una fila nueva.
COMMIT;

Diseña además una ruta de compensación para efectos parciales. Si se creó un registro pero falló el email, no borres a ciegas: marca el envío como pendiente y reanúdalo. Guarda solo la información necesaria para operar y auditar. Finalmente, prueba cada rama con ejemplos válidos, datos incompletos, duplicados, timeout y respuestas no esperadas antes de activar el trigger.

Preguntas frecuentes

¿Qué diferencia hay entre un workflow y un agente en n8n?

Un workflow sigue una ruta definida por nodos y condiciones. Un agente puede elegir herramientas según el contexto. Esa autonomía exige límites, permisos mínimos, salida validada y aprobación humana para acciones de impacto.

¿Puedo instalar n8n con Docker Compose sin usar la etiqueta latest?

Sí. Define N8N_IMAGE en el entorno con una etiqueta o digest probado. El Compose queda reutilizable y una actualización requiere cambiar la referencia de forma deliberada.

¿Cómo se pasan datos entre nodos en n8n?

Mediante ítems, normalmente objetos JSON y, cuando procede, binarios. Las expresiones leen campos del ítem actual o de nodos anteriores. Inspecciona siempre la estructura antes de mapearla.

¿Cómo debo guardar las credenciales?

En el almacén de credenciales de n8n, protegido por una clave de cifrado estable. Los secretos del despliegue deben vivir fuera del repositorio, separados por entorno y con permisos mínimos.

¿Qué significa que un workflow sea idempotente?

Que procesar dos veces el mismo evento produce un solo efecto. Se consigue con identificadores únicos, deduplicación, operaciones upsert y estados persistentes.

¿Cuándo necesita aprobación humana un agente?

Antes de enviar comunicaciones, modificar o borrar datos, ejecutar pagos, publicar contenido o realizar una acción difícil de revertir. El agente prepara; la persona responsable decide.