
n8n + Inteligencia Artificial Local — Automatización de Procesos y Agentes
Temario oficial · 18 horas · Instituto Linux
Docente: Fabian Ampalio
Octubre 2026
Plataforma: n8n 2.x Local / Self-Hosted (Node.js LTS, GitHub) · Ollama (LLM Local) · SQLite / PostgreSQL · Telegram API
1. Información clave del programa
| Ítem | Detalle |
|---|---|
| Duración | 18 horas reloj · 9 clases de 2 horas |
| Frecuencia | Jueves, 18:00 a 20:00 (ART) |
| Inicio | Jueves 17 de septiembre de 2026 |
| Metodología de Clase | 1ª Hora: Exposición teórica y demostración en vivo por el docente. 2ª Hora: Taller práctico guiado en equipos sobre el entorno local propio. |
Calendario de clases
| # | Fecha | Módulo |
|---|---|---|
| 1 | Jue 01/10 | Arquitectura e instalación nativa de n8n sobre Node.js y GitHub |
| 2 | Jue 08/10 | El modelo de datos: items, expresiones, JSON y lógica de control |
| 3 | Jue 15/10 | Webhooks, triggers y bots de Telegram con BotFather |
| 4 | Jue 22/10 | Automatización de Moodle: gestión de usuarios, matrículas y Web Services |
| 5 | Jue 29/10 | Integración con ARCA (ex-AFIP) y facturación por API REST/SOAP |
| 6 | Jue 05/11 | Inteligencia Artificial local con Ollama e integración en n8n |
| 7 | Jue 12/11 | Agentes de IA conversacionales con memoria persistente en Telegram |
| 8 | Jue 19/11 | Herramientas (Tools) y RAG: agentes que consultan datos propios |
| 9 | Jue 26/11 | Puesta en producción, seguridad, diagnóstico y proyecto integrador |
3. Objetivos específicos
Al finalizar, el participante podrá:
- Instalar y ejecutar n8n localmente sobre Node.js usando npm/npx o el repositorio oficial de GitHub, prescindiendo del uso de contenedores Docker.
- Gestionar variables de entorno críticas y comprender el modelo de persistencia local con SQLite y PostgreSQL.
- Dominar el modelo de ejecución de n8n: items, arrays, ramas, ejecuciones parciales y transformar payloads complejos mediante el nodo Edit Fields y expresiones JS.
- Diseñar flujos con lógica de control: condicionales, ruteo múltiple (Switch), uniones de ramas (Merge) e iteraciones controladas (Split in Batches).
- Exponer y asegurar endpoints HTTP/Webhooks para recibir eventos externos y procesar callbacks en tiempo real.
- Construir e integrar bots de Telegram interactivos creados vía BotFather, gestionando comandos, webhooks e interacciones en tiempo real.
- Automatizar la administración de Moodle mediante su API de Web Services (creación de usuarios, matriculación masiva y consulta de cursos).
- Orquestar procesos de facturación e integración con ARCA (ex-AFIP), gestionando autenticación, certificados digitales y payloads XML/JSON.
- Desplegar modelos de Lenguaje de Gran Escala (LLMs) locales con Ollama en el equipo propio y conectarlos nativamente a n8n.
- Construir agentes de Inteligencia Artificial conversacionales con memoria persistente por usuario y system prompts acotados.
- Dotar a los agentes de IA de herramientas avanzadas (Tools) para consultar bases de datos relacionales, invocar sub-workflows y consultar APIs.
- Implementar arquitecturas RAG (Retrieval-Augmented Generation) sobre documentación interna propia con almacenamiento de vectores locales.
- Aplicar un esquema riguroso de manejo de errores, sub-workflows modulares y notificaciones proactivas de fallas.
- Diagnosticar fallas operativas reales: tokens de API vencidos, referencias vacías en JSON, respuestas inesperadas de servicios externos y desvíos en agentes de IA.
4. A quién está dirigido
Perfil principal
- Administradores de sistemas y personal de IT que buscan reemplazar scripts sueltos y tareas programadas por flujos auditables, mantenibles y centralizados.
- Administradores de plataformas educativas (Moodle) que necesitan automatizar las altas de alumnos, cobros y notificaciones sin intervención manual.
- Desarrolladores y técnicos de PyMEs que deben conectar sistemas heterogéneos: facturación (ARCA/AFIP), campus virtuales, CRM y mensajería instantánea.
- Responsables de operaciones y administración que ejecutan procesos repetitivos de alto volumen y buscan eficientizar el back-office localmente.
- Consultores, freelancers e integradores que desean incorporar automatizaciones con IA local a su catálogo de servicios profesionalizables.
Perfil secundario
- Emprendedores técnicos que están desarrollando un producto y necesitan orquestar procesos sin depender de servicios SaaS costosos.
- Docentes y responsables de laboratorios de informática que desean incorporar automatización e IA local en sus programas de estudio.
No es para
- Personas sin ninguna base técnica previa. El curso presupone manejo básico de terminal y conceptos generales de comunicación por red/APIs.
5. Requisitos previos
Conocimientos obligatorios:
- Manejo básico de terminal/línea de comandos (Linux Bash o Windows PowerShell/CMD).
- Comprensión conceptual de APIs REST: métodos HTTP (GET, POST), URLs y headers.
- Lectura y estructura de datos en formato JSON (objetos, arrays, llaves y valores).
Deseable, no excluyente:
- Nociones básicas de JavaScript (variables, condicionales).
- Experiencia previa administrando Moodle, realizando trámites en ARCA/AFIP o usando bots de Telegram.
6. Laboratorio requerido
El curso se desarrolla con las manos en el teclado desde la primera clase. Cada estudiante utilizará su propia máquina de trabajo:
Equipamiento y software local:
- PC o notebook con **8 GB de RAM mínimo** (16 GB recomendado para la ejecución fluida de modelos locales con Ollama).
- Sistema Operativo: Linux (Debian, Ubuntu o derivados) o Windows 10/11.
- Node.js LTS (v20 o v22) e Gestor de paquetes `npm` instalados en el sistema.
- Git instalado para la obtención del código fuente.
- Ollama instalado localmente para el módulo de Inteligencia Artificial.
- Conexión estable a internet para el consumo e integración con APIs externas.
7. Temario detallado
Clase 1 — Arquitectura e instalación nativa de n8n sobre Node.js y GitHub
Jueves 17/09
Objetivo de la clase: dejar una instancia de n8n instalada y operativa localmente sobre el sistema operativo propio (Linux/Windows) sin Docker, comprendiendo la arquitectura sobre Node.js.
- Evolución de la automatización: del script aislado en bash/Python al motor de orquestación auditable.
- Qué es n8n y su arquitectura nativa basada en Node.js y TypeScript.
- Licenciamiento: Community Edition self-hosted, repositorios de GitHub y términos de uso comercial.
- Instalación paso a paso en el equipo local: prerrequisitos de Node.js LTS y npm.
- Despliegue nativo mediante `npm install -g n8n` y clonado desde el repositorio de GitHub.
- Variables de entorno locales críticas:
N8N_ENCRYPTION_KEY,N8N_PORT,N8N_USER_FOLDERy zona horaria. - Persistencia nativa: base de datos SQLite embebida por defecto frente a PostgreSQL externo.
- Recorrido por la interfaz web local (canvas, panel de nodos, ejecuciones, credenciales).
- Estructura interna de un workflow: nodos, conexiones y el JSON subyacente. Exportación e importación manual.
- Primer flujo funcional: Manual Trigger → HTTP Request a una API pública → Edit Fields → Inspección del resultado.
Taller en equipos (1h): Instalación de Node.js y n8n en las computadoras de los alumnos, configuración de la clave de cifrado local y ejecución del primer workflow de prueba.
Clase 2 — El modelo de datos: items, expresiones, JSON y lógica de control
Jueves 24/09
Objetivo de la clase: dominar la estructura de datos que viaja entre nodos y aplicar transformación y ruteo de información de forma limpia y defensiva.
- El Item como unidad fundamental de ejecución: por qué los nodos procesan listas y qué implica que un flujo itere automáticamente.
- Estructura del item: separaciones de datos `json` y datos binarios `binary`.
- Sintaxis de expresiones
{{ $json.campo }}y variables globales ($now,$execution,$env). - Referencias a nodos previos no adyacentes:
$('Nombre_Nodo').item.json.campoy cómo evitar referencias nulas. - Uso de optional chaining (
?.) para prevenirlos fallos por campos faltantes en JSONs dinámicos. - Nodo Edit Fields (Set): normalización, mapeo y limpieza temprana de datos.
- Control de flujo: condicionales IF, ruteo múltiple con Switch y nodo Filter.
- Manejo de arrays: Split Out, Aggregate y patrones de bucle con Split In Batches.
- Uso del Code Node con JavaScript para transformaciones complejas cuando las expresiones no alcanzan.
Taller en equipos (1h): Dada una respuesta JSON ruidosa y anidada de un sistema, normalizarla a un objeto plano y clasificar los datos por tres rutas diferentes según su contenido.
Clase 3 — Webhooks, triggers y bots de Telegram con BotFather
Jueves 01/10
Objetivo de la clase: conectar n8n con eventos del mundo exterior exponiendo Webhooks y construyendo un bot interactivo de Telegram.
- Anatomía de los nodos Trigger: Schedule (cron) frente a llamadas por eventos HTTP externos.
- Webhook Node: métodos (GET/POST), paths, autenticación por Header y tipos de respuesta.
- Diferencia crítica entre Test URL y Production URL durante el desarrollo.
- Túneles de desarrollo local (ngrok / n8n tunnel) para recibir webhooks públicos en la máquina local.
- Creación de un Bot en Telegram mediante @BotFather: obtención de API Token y configuración de comandos.
- Configuración del nodo nativo de Telegram en n8n y escucha de eventos mediante Telegram Trigger.
- Enviando mensajes formateados (Markdown/HTML), botones interactivos y respuesta a comandos específicos (`/start`, `/ayuda`).
- Filtrado temprano de eventos en la entrada para procesar únicamente los mensajes relevantes.
Taller en equipos (1h): Crear un bot propio en Telegram con @BotFather y armar un flujo en n8n local que responda a comandos dinámicos y procese mensajes enviados por los integrantes del equipo.
Clase 4 — Automatización de Moodle: gestión de usuarios, matrículas y Web Services
Jueves 08/10
Objetivo de la clase: orquestar la integración con la plataforma educativa Moodle para automatizar altas, matriculaciones y consultas de alumnos.
- Arquitectura de la API de Web Services de Moodle: habilitación de protocolos REST, creación de tokens y asignación de funciones.
- Configuración del nodo HTTP Request en n8n para comunicarse con endpoints de Moodle.
- Operación de alta de usuarios: invocando la función
core_user_create_userspasando parámetros en formato URL-encoded o JSON. - Verificación previa de existencia de usuarios mediante
core_user_get_userspara evitar duplicaciones. - Matriculación automática de alumnos en cursos mediante
enrol_manual_enrol_users. - Manejo de respuestas de error internas de Moodle (retorno de códigos 200 HTTP con un payload JSON de error).
- Conexión del flujo: Solicitud recibida vía Telegram/Webhook → Verificación en Moodle → Alta y Matriculación → Notificación de confirmación al alumno.
Taller en equipos (1h): Construir un flujo que reciba una solicitud con datos de un estudiante desde Telegram y ejecute el alta y matriculación automática en un entorno Moodle de pruebas.
Clase 5 — Integración con ARCA (ex-AFIP) y facturación por API REST/SOAP
Jueves 15/10
Objetivo de la clase: entender y estructurar los flujos de integración con servicios de facturación electrónica e inspección de padrones (ARCA/ex-AFIP).
- Modelos de comunicación con ARCA: arquitectura de autenticación WSAA (Web Service de Autenticación y Autorización) y WSFE (Facturación Electrónica).
- Gestión de certificados digitales (.crt / .key) y firmas CMS dentro de automatizaciones.
- Consumo de Web Services SOAP/XML desde n8n usando el nodo HTTP Request y transformación de XML a JSON.
- Consulta de datos de contribuyentes (padrón de CUITs) y validación de condición fiscal.
- Estructuración de solicitudes de emisión de comprobantes (solicitud de CAE) y manejo de respuestas de rechazo u observaciones.
- Diseño de un ciclo completo: Recepción de pago/alta → Validación de CUIT en ARCA → Generación de comprobante → Notificación y almacenamiento local.
Taller en equipos (1h): Implementar una simulación completa de consulta de padrón e ingreso de datos para facturación, manejando la transformación de datos y la gestión de errores de validación.
Clase 6 — Inteligencia Artificial local con Ollama e integración en n8n
Jueves 22/10
Objetivo de la clase: instalar y ejecutar un motor de IA local con Ollama en el propio equipo e integrarlo nativamente dentro de los flujos de n8n.
- Ventajas de la IA Local: privacidad absoluta de datos, soberanía del dato, latencia controlada y costo cero por token.
- Instalación y configuración de **Ollama** en Linux y Windows.
- Gestión de modelos mediante la CLI de Ollama (`ollama pull`, `ollama run`): evaluando modelos livianos (
llama3.2,phi3,mistral). - Exposición del servicio local de Ollama (puerto 11434) para consumo por API REST.
- Ecosistema de IA en n8n: Nodos de LangChain, nodo **Basic LLM Chain** y sub-nodo **Ollama Model**.
- Configuración de credenciales locales de Ollama en n8n (`http://localhost:11434` o IP local).
- Diseño de **System Prompts** efectivos: delimitación de roles, restricciones de respuesta y formato de salida.
- Procesamiento de texto libre: resúmenes automáticos, extracción de entidades e intención del usuario desde mensajes.
Taller en equipos (1h): Descargar un modelo liviano en Ollama local y construir un workflow en n8n que reciba una consulta larga de un estudiante y devuelva un análisis y clasificación estructurada.
Clase 7 — Agentes de IA conversacionales con memoria persistente en Telegram
Jueves 29/10
Objetivo de la clase: construir un agente conversacional inteligente utilizando el nodo AI Agent de n8n con memoria contextual multi-usuario conectado a Telegram.
- Diferencia fundamental entre llamada simple a un LLM y un **Agente de IA** (capacidad de razonamiento, decisión y uso de herramientas).
- Anatomía del nodo **AI Agent** en n8n: conexión de modelos, memorias, parsers y herramientas.
- Gestión de la **Memoria Conversacional**: sub-nodo *Window Buffer Memory*.
- La importancia crítica de la clave de sesión (
sessionKey): usando el Chat ID de Telegram para aislar las conversaciones de distintos usuarios. - Persistencia de memoria en base de datos local frente a memoria volátil en RAM.
- Mitigación de alucinaciones en el agente mediante System Prompts defensivos.
- Ensamblado del Bot Tutor Virtual: Telegram Trigger → AI Agent (Ollama + Memoria) → Telegram Response.
Taller en equipos (1h): Transformar el bot de Telegram de la Clase 3 en un Tutor Virtual impulsado por Ollama que mantenga el hilo de la conversación individualmente con cada miembro del equipo.
Clase 8 — Herramientas (Tools) y RAG: agentes que consultan datos propios
Jueves 05/11
Objetivo de la clase: dotar al agente de IA local de capacidad de acción mediante Tools y conectarlo a fuentes de conocimiento propio mediante RAG.
- Concepto de **Tools (Herramientas)** en agentes: cómo el modelo decide cuándo ejecutar código o consultar un sistema.
- La descripción de la herramienta como prompt de decisión: buenas y malas prácticas.
- Creación de herramientas personalizadas (*Custom Workflow Tool*): permitiendo al agente consultar el estado de un alumno en Moodle o validar un CUIT.
- Introducción a **RAG (Retrieval-Augmented Generation)**: diferencia entre datos estructurados (consultas SQL/API) y datos no estructurados (documentos, PDFs, reglamentos).
- Carga e ingesta de documentos locales: chunking (fragmentado), modelos de embeddings locales y almacenamiento vectorial en bases relacionales o vectoriales locales.
- Conectando una herramienta de búsqueda vectorial al agente para responder dudas institucionales basándose únicamente en el reglamento cargado.
- Trazabilidad de ejecuciones: lectura de logs de razonamiento para diagnosticar qué herramienta seleccionó el agente en cada turno.
Taller en equipos (1h): Conectar dos herramientas al agente de Telegram (una consulta de datos a Moodle y una búsqueda de respuestas sobre un documento PDF local) y verificar el razonamiento del agente.
Clase 9 — Puesta en producción, seguridad, diagnóstico y proyecto integrador
Jueves 12/11
Objetivo de la clase: consolidar las buenas prácticas de operación, respaldo, seguridad e itinerario de diagnóstico, y presentar el proyecto integrador final.
- Estrategias de despliegue productivo de n8n nativo: gestión del servicio mediante administradores de procesos (PM2 o servicios systemd en Linux).
- Manejo de errores a nivel de plataforma: **Error Workflows**, captura global de fallas y notificaciones proactivas vía Telegram.
- Politica de seguridad local: resguardo de secretos fuera del flujo, cifrado de credenciales y rotación de tokens de API.
- Respaldo y recuperación de la instancia: copia de la base de datos (SQLite/Postgres), exportación automatizada de workflows a formato JSON y custodia de la
N8N_ENCRYPTION_KEY. - Versionado de workflows en repositorios Git locales o remotos.
- Guía de troubleshooting sistemático:
- Webhooks que no disparan o quedan colgados.
- Errores de referencia en JSON (
undefined) y fallos en expresiones. - Credenciales o tokens vencidos en servicios externos (Moodle, Telegram, ARCA).
- Agentes de IA que alucinan o entran en bucles de llamadas a herramientas.
- Presentación y evaluación técnica de los proyectos integradores desarrollados por los estudiantes.
Laboratorio final / proyecto integrador: Demostración de un flujo automatizado completo e instalado en la máquina propia que integre: captura de eventos vía Telegram → validación o alta de usuario en Moodle / Facturación → Agente de Ollama con herramientas de consulta → respuesta al usuario y manejo centralizado de errores.
8. Metodología
- Clases en vivo de 2 horas con modalidad de alta interacción y grabación disponible para repaso.
- Estructura 50/50: 1ª hora dedicada a la exposición conceptual y demostración en vivo por parte del docente; 2ª hora orientada al taller práctico guiado en equipos sobre la instalación propia de cada participante.
- Instalación 100% nativa local: El stack corre directamente sobre Node.js y el SO del alumno, garantizando independencia de la nube y cero costos recurrentes.
- Desafíos por clase: Cada encuentro concluye con una consigna práctica a resolver en el laboratorio individual.
- Entregables y recursos: Se proveen plantillas de workflows en JSON, scripts de automatización, colecciones de prompts y guías paso a paso al cierre de cada módulo.
- Canal de consultas técnicas permanente a lo largo de toda la cursada.
9. Evaluación y certificación
- Resolución de laboratorios prácticos semanales.
- Proyecto Integrador Final: Construcción, documentación y demostración funcional de una solución de automatización integral según los requerimientos de la Clase 9.
- Certificado de aprobación emitido por Instituto Linux / Carrera Linux, con acreditación detallada de contenidos y carga horaria (18 hs).
10. Fuentes de referencia
- Documentación oficial de n8n: https://docs.n8n.io
- Guía de instalación via npm/Node.js: https://docs.n8n.io/hosting/installation/npm/
- Repositorio oficial de n8n en GitHub: https://github.com/n8n-io/n8n
- Documentación oficial de Ollama: https://ollama.com
- Documentación de Moodle Web Services API: https://docs.moodle.org/dev/Web_services
- Documentación de Telegram Bot API: https://core.telegram.org/bots/api
- Documentación de Servicios Web AFIP / ARCA: https://www.afip.gob.ar/ws/

Instituto Linux es el ÚNICO instituto de educación a distancia AUTORIZADO por el LINUX PROFESSIONAL INSTITUTE y la LINUX FOUNDATION en el mundo, en idioma español, para formación presencial y a distancia

Todos nuestros cursos pueden ser contratados de forma individual o corporativa
Por consultas, comunícate al +54 9 11 69699993








