Manual de n8n · de cero a automatizar

CAPÍTULO 01

Qué es n8n (en simple)

n8n es una herramienta para conectar tus apps y hacer que trabajen solas. Tú dibujas el proceso arrastrando "cajitas" (nodos) y las unes con líneas. n8n se encarga de ejecutarlo.

La mejor forma de entenderlo: imagina una línea de producción de una fábrica. Entra materia prima por un lado, pasa por varias estaciones (cada una hace una tarea) y sale un producto terminado. En n8n cada estación es un nodo y la cinta transportadora que las une es la conexión.

FIG. 1 — n8n visto como fábrica: trigger → nodos → resultado

Otra forma de verlo: es como contratar a un empleado robot que nunca duerme. Le enseñas una vez qué hacer ("cuando entre un pedido por WhatsApp, revisa la zona, avisa al motorizado y anótalo en la hoja de cálculo") y lo repite para siempre, gratis, a cualquier hora.

La idea en una frase

n8n = "cuando pase ESTO, haz AQUELLO" — pero encadenando todos los "aquello" que quieras, entre todas tus apps.

¿Qué se puede automatizar?

Responder mensajes de WhatsApp/Telegram automáticamente.
Pasar pedidos de un formulario a una hoja de Google o a Firebase.
Mandar reportes diarios a tu correo o WhatsApp cada noche.
Publicar en Facebook con textos e imágenes hechos por IA.
Recordarle a un cliente que ya le toca recargar su balón de gas.
Conectar un chatbot con IA que atienda pedidos 24/7.

n8n es gratis y de código abierto (puedes instalarlo en tu propio servidor sin pagar nada) y también existe la versión en la nube que ellos manejan por ti. Nació en 2019 en Berlín y hoy es una de las herramientas de automatización más usadas del mundo.

El nombre se lee "n-eight-n" (ene-ocho-ene) y viene de nodemation = node (nodo) + automation (automatización).

CAPÍTULO 02

Por qué n8n y no Zapier o Make

Zapier y Make hacen lo mismo, pero n8n tiene tres ventajas que a un operador de negocio le importan de verdad: costo, poder y control.

	n8n	Zapier / Make
Costo a volumen	Muy bajo (o gratis si lo autohospedas)	Se dispara rápido: a 50 mil tareas/mes puede costar cientos de dólares
Límite de pasos	Ilimitado por flujo	Cobran por tarea/paso
Poder	Puedes meter código, lógica compleja y llamadas a cualquier API	Más limitado; ideal solo para flujos simples
Control de datos	Puedes tener TODO en tu propio servidor	Tus datos pasan por sus servidores
IA / Agentes	Nodo AI Agent nativo, muy potente	Básico
Curva de aprendizaje	Un poco más empinada al inicio	Más fácil los primeros 5 minutos

Para Altoke Gas

Si vas a mover muchos mensajes de WhatsApp, pedidos y reportes todos los días, Zapier te saldría carísimo. Con n8n autohospedado pagas solo el servidor (unos pocos dólares al mes) y corres todo lo que quieras. Es la opción correcta para tu stack (N8N + Claude + WhatChimp + Firebase).

FIG. 2 — A volumen de negocio real, la diferencia de costo es brutal

La contra honesta: n8n exige entender un poco más al principio (nodos, datos, expresiones). Pero justo para eso es este manual. Una vez que le agarras la lógica, es mucho más flexible.

CAPÍTULO 03

Los 6 conceptos base

Si entiendes estas 6 palabras, entiendes n8n. Todo lo demás son detalles.

FIG. 3 — Los 6 conceptos, todos en un solo mapa

1 · Workflow (flujo)

Es tu automatización completa: el "mapa" con todos los nodos conectados. Un workflow = una tarea automatizada. Ej: "Reporte de cierre diario" es un workflow.

2 · Nodo

Cada cajita que hace una cosa: leer un mensaje, enviar un correo, decidir sí/no, llamar a una API. Arrastras nodos al lienzo y los configuras.

3 · Conexión

La línea que une un nodo con el siguiente. Marca el orden: primero este, luego este otro. Los datos "viajan" por esas líneas de izquierda a derecha.

4 · Trigger (disparador)

El primer nodo, el que arranca todo. Responde a la pregunta "¿cuándo debe correr esto?". Ej: "cada día a las 10pm", "cuando llegue un WhatsApp", "cuando alguien llene un formulario". Sin trigger, el flujo no arranca.

5 · Ejecución (execution)

Cada vez que el workflow corre, eso es una ejecución. n8n guarda un historial: puedes entrar y ver exactamente qué pasó, qué datos entraron y salieron de cada nodo. Esto es oro para arreglar errores.

6 · Item / dato (JSON)

La información que viaja entre nodos. Cada "item" es un paquetito de datos. n8n los maneja en formato JSON (pares nombre: valor). No te asustes, se lee facilísimo:

// un item = un pedido { "cliente": "Rosa Q.", "balon": "Vitagas 10kg", "cantidad": 1, "zona": "Tica Tica", "pagado": true }

Memoriza este orden

Trigger → Nodos → Conexiones → Datos que viajan → Ejecución. Todo workflow, por complejo que sea, es solo esto repetido.

CAPÍTULO 04

Cómo empezar: Cloud o propio

Hay dos caminos para tener n8n funcionando. Elige según tu momento.

Opción A · n8n Cloud (lo más fácil)

Ellos alojan todo. Creas cuenta en n8n.io, tienes prueba gratis y empiezas a construir en 2 minutos. Ideal para aprender y probar sin complicarte con servidores.

Planes de pago que arrancan alrededor de US$20–24/mes el básico (los precios cambian, revisa la web).
Cobran por número de ejecuciones, no por pasos.
Cero mantenimiento: siempre actualizado.

Opción B · Autohospedado (lo más barato a la larga)

Instalas n8n en tu propio servidor (un VPS de Hostinger, DigitalOcean, Contabo, etc.). Pagas solo el servidor y corres ejecuciones ilimitadas. Es la ruta que tú ya usas.

La forma más común: Docker

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

Luego entras desde el navegador a http://tu-servidor:5678. Para producción de verdad se usa docker compose con base de datos Postgres y un dominio con HTTPS, pero para empezar esto basta.

Ojo

Autohospedado significa que tú te encargas de las actualizaciones, respaldos y que el servidor no se caiga. Si recién arrancas y quieres aprender rápido, usa Cloud unas semanas y luego migras a tu servidor cuando ya domines los flujos.

Recomendación por etapas

Semana 1–2: n8n Cloud (prueba gratis). Enfócate en entender nodos y datos.
Cuando ya construyas flujos reales: autohospedas en un VPS para no pagar por ejecución.

FIG. 4 — El camino inteligente: aprende en Cloud, produce en tu VPS

CAPÍTULO 05

La pantalla por dentro

Cuando abres un workflow ves un lienzo (canvas) con puntitos, igual que el fondo de este manual. Aquí va lo que hay en pantalla.

FIG. 5 — El editor de n8n con sus zonas clave señaladas

El editor real de n8n con el lienzo, la barra superior y un workflow — **Así se ve de verdad.** Compara con el mapa de arriba: el lienzo con puntitos, la barra superior con el nombre y el toggle, y el botón + a la derecha para agregar nodos. Toca la imagen para ampliarla.

Recorrido animado por el editor de n8n — **Tour animado del editor** (de la escuela oficial de n8n): mira cómo se navega el lienzo, se abren los paneles y dónde vive cada cosa. Véelo 2 veces y la pantalla ya no te será extraña.

Zona	Qué es
Lienzo	El área grande con puntitos donde arrastras y conectas nodos.
Botón +	Arriba a la derecha (o al tocar un nodo). Abre el buscador para agregar un nodo nuevo.
Panel del nodo	Al hacer doble clic en un nodo se abre a los lados: entrada (datos que llegan), configuración (centro) y salida (datos que produce).
Botón Test / Execute	Corre el flujo ahí mismo para probar. Verás los datos reales pasar por cada nodo.
Toggle Active	Interruptor arriba a la derecha. Inactivo = solo corre cuando lo pruebas. Activo = corre solo cuando su trigger se dispara en la vida real.
Executions	Pestaña con el historial de cada corrida. Tu mejor amiga para depurar.
Credentials	Donde guardas tus llaves de acceso a Gmail, WhatsApp, OpenAI, etc. (ver cap. 11).

El panel de 3 columnas

Es lo más importante de entender. Al abrir un nodo: izquierda = lo que le llega. Centro = lo que configuras. Derecha = lo que sale hacia el siguiente nodo. Si algo falla, mira siempre estas tres columnas.

FIG. 6 — El panel del nodo: entrada · configuración · salida

CAPÍTULO 06

Los 4 tipos de nodos

Todos los cientos de nodos de n8n caen en 4 grandes familias. Si reconoces la familia, sabes para qué sirve.

Trigger — arranca Acción — hace algo Lógica — decide IA — piensa

FIG. 7 — El mapa mental: toda pieza de n8n cae en una de estas 4 familias

Panel de nodos de n8n con las categorías — **El panel de nodos real**: se abre con el botón + (o la tecla Tab) y ahí viven las 4 familias listas para arrastrar.

Buscando un nodo por nombre en n8n — **Así se busca un nodo**: escribes el nombre (Gmail, IF, Schedule…) y aparece al instante. No hay que memorizar dónde está nada.

● Triggers (disparadores)

Arrancan el flujo. Solo puede haber uno como inicio. Los más usados:

Schedule — a una hora/día fijos ("cada noche 10pm").
Webhook — cuando otra app le "toca la puerta" con datos (así conectas WhatsApp, formularios, etc.).
Chat Trigger — cuando alguien escribe en un chat (para agentes de IA).
Manual Trigger — el botón de "probar". Para desarrollar.

● Acciones

Hacen el trabajo: enviar, crear, leer, escribir. Ej: enviar Gmail, escribir en Google Sheets, publicar en Facebook, llamar a una API con HTTP Request.

● Lógica / control

Deciden y ordenan el camino: IF (sí/no), Switch (varios caminos), Merge (juntar ramas), Filter (dejar pasar solo lo que cumple), Loop (repetir por cada item).

FIG. 8 — El nodo IF: un dato, dos caminos

● IA

Piensan y generan: AI Agent, modelos de chat (Claude, GPT, Gemini), memoria, herramientas (tools) y almacenes de vectores para RAG. Todo el cap. 13 es sobre esto.

Truco mental

Al armar un flujo pregúntate en orden: ¿cuándo arranca? (trigger) → ¿tengo que decidir algo? (lógica) → ¿qué acciones hago? (acción) → ¿necesito que piense? (IA).

CAPÍTULO 07

Tu primer workflow, paso a paso

Vamos a construir el clásico "hola mundo" útil: cada noche, mándame por correo un resumen. Simple, pero toca todo lo importante.

⏰

Cada día 10pm

Schedule

✎

Armar texto

Edit Fields

✉

Enviar correo

Gmail

Agregando un nodo desde el botón + en n8n — **El gesto más repetido de tu vida en n8n**: tocar el +, buscar el nodo y soltarlo en el lienzo. Es lo que harás en los pasos 2, 3 y 4 de abajo.

Crea un workflow nuevo
Botón "New workflow". Verás el lienzo vacío con un cartel de "Add first step".
Agrega el trigger Schedule
Toca +, busca "Schedule". Configúralo para correr cada día a las 22:00. Este nodo hará que todo arranque solo.
Agrega un nodo Edit Fields (Set)
Toca el + del Schedule, busca "Edit Fields". Crea un campo llamado mensaje con valor Resumen del día listo ✅. Aquí se arma la información.
Agrega Gmail → Send
Toca +, busca "Gmail", elige la acción Send Message. Conecta tu cuenta (credencial). En el cuerpo pon la expresión {{ $json.mensaje }} para insertar lo que armaste.
Prueba con Execute Workflow
Míralo correr. Revisa la salida de cada nodo (columna derecha). ¿Llegó el correo? 🎉
Actívalo
Sube el interruptor Active arriba a la derecha. Ahora corre solo cada noche, sin que hagas nada.

Workflow ejecutado con éxito en n8n, nodos con check verde — **Prueba exitosa**: cuando corres el flujo y todo sale bien, cada nodo se marca con su check verde ✓.

Workflow activado con el interruptor Active encendido — **Paso final — activado**: con el interruptor **Active** en verde, el flujo corre solo aunque cierres la computadora.

Lo que acabas de aprender

Trigger que arranca solo → un nodo que prepara datos → una acción que los usa → probar → activar. Ese esqueleto es el 90% de todos tus futuros flujos.

CAPÍTULO 08

Los nodos que sí o sí debes saber

No necesitas los cientos de nodos. Con estos ~15 armas casi cualquier cosa. Apréndelos y ya eres peligroso.

Para arrancar (triggers)

Nodo	Para qué
Manual Trigger	Probar mientras desarrollas.
Schedule Trigger	Correr a horas/días fijos (reportes, recordatorios).
Webhook	Recibir datos de otras apps (WhatsApp, formularios, TikTok, tu web V7).
Chat Trigger	Iniciar un agente de IA cuando alguien escribe.

Para mover y transformar datos

Nodo	Para qué
Edit Fields (Set)	Crear o cambiar campos. El más usado para "armar" datos.
HTTP Request	Llamar a CUALQUIER API que exista. La navaja suiza.
Code	Meter JavaScript o Python cuando ningún nodo hace justo lo que quieres.
Merge	Juntar datos de dos ramas.
Aggregate	Resumir varios items en uno (sumar, contar, juntar en lista).

Para decidir (lógica)

Nodo	Para qué
IF	Bifurcar en dos caminos: verdadero / falso.
Switch	Varios caminos según un valor (ej: por zona de reparto).
Filter	Dejar pasar solo los items que cumplen una condición.
Loop / Split in Batches	Repetir una acción por cada item (ej: mandar msj a cada cliente).
Wait	Pausar (segundos, minutos, o hasta una fecha) antes de seguir.
NoOp	"No hace nada". Sirve para ordenar visualmente o cerrar una rama.

Nodo HTTP Request abierto en n8n — **HTTP Request por dentro**: método, URL y parámetros. La navaja suiza — con este nodo hablas con WhatChimp, Firebase o cualquier API.

Nodo IF configurado con una condición en n8n — **El nodo IF por dentro**: defines la condición (izquierda: el dato · centro: la regla · derecha: el valor) y el flujo se parte en true/false.

Apps que usarás siempre

Google Sheets — leer/escribir en hojas de cálculo.
Gmail — enviar y leer correos.
Telegram — bots y avisos (rapidísimo de configurar).
OpenAI / Anthropic (Claude) — generar texto e imágenes con IA.
HTTP Request — para todo lo demás (WhatsApp por API, Firebase, etc.).

Para tu stack

WhatChimp y Firebase normalmente los conectas con Webhook (para recibir) y HTTP Request (para enviar/leer). Con dominar esos dos ya integras casi cualquier cosa que hoy usas en Altoke Gas.

CAPÍTULO 09

Cómo viajan los datos

Este es EL concepto que separa al que "sabe" del que "adivina". Si entiendes cómo se mueven los datos, dejas de pelear con n8n.

Todo son items

Cada nodo recibe una lista de items y produce otra lista de items. Un item es un paquetito JSON. Si entran 5 pedidos, normalmente el nodo se ejecuta 5 veces (uno por item) y saca 5 resultados.

FIG. 9 — Los items viajan como paquetes: uno por cliente, uno por pedido

// SALIDA de un nodo = lista de items [ { "cliente": "Rosa", "zona": "Tica Tica" }, { "cliente": "Luis", "zona": "Wanchaq" } ]

El panel te muestra los datos reales

Cuando pruebas un flujo, cada nodo guarda lo que entró y lo que salió. Puedes verlo en tabla, en JSON o como esquema. Siempre revisa la salida del nodo anterior para saber qué nombres de campo tienes disponibles.

Salida de un nodo en vista de tabla en n8n — **Vista TABLA**: cada fila es un item, cada columna un campo. La más cómoda para revisar de un vistazo.

Salida de un nodo en vista JSON en n8n — **Vista JSON**: los mismos datos como paquetitos. Aquí ves los nombres EXACTOS de los campos para tus expresiones.

Cómo apuntar a un dato

Para usar un dato del nodo anterior escribes $json.nombreDelCampo. Ejemplos:

Escribes	Obtienes
`$json.cliente`	El valor del campo "cliente" del item actual
`$json.zona`	El valor de "zona"
`$json["balon 10kg"]`	Cuando el nombre tiene espacios, usa corchetes
`$node["Webhook"].json.telefono`	Un dato de OTRO nodo por su nombre

El error #1 de todos

"No me sale el dato". Casi siempre es porque el nombre del campo está mal escrito (mayúsculas, tildes, espacios) o porque el nodo anterior en realidad no produjo ese campo. Abre la salida del nodo anterior y copia el nombre exacto. En n8n puedes arrastrar el campo desde el panel de la izquierda directo a la casilla — así nunca te equivocas.

CAPÍTULO 10

Expresiones: el corazón

Las expresiones son cómo insertas datos dinámicos en cualquier casilla. Se escriben entre doble llave: {{ ... }}. Dominarlas es dominar n8n.

Donde veas un campo de texto, puedes cambiarlo de "fijo" a "expresión" y meter datos vivos. Todo lo que va dentro de {{ }} es JavaScript.

FIG. 10 — Anatomía de una expresión: dato → plantilla → mensaje final

Arrastrando un campo del panel de entrada a una expresión en n8n — **El truco que evita el 90% de los errores**: arrastras el campo desde el panel izquierdo y n8n escribe la expresión perfecta por ti. Mira el punto verde del cursor.

Editor de expresiones de n8n mostrando el resultado en vivo — **El editor de expresiones real**: escribes arriba y abajo ves el **resultado con tus datos reales** antes de guardar. Si sale verde, va a funcionar.

Ejemplos que usarás todo el tiempo

// insertar un dato Hola {{ $json.cliente }}, tu pedido va en camino 🛵 // juntar varios datos {{ $json.cliente }} pidió {{ $json.cantidad }} balón(es) de {{ $json.balon }} // fecha de hoy formateada Cierre del {{ $now.format('dd/MM/yyyy') }} // operar con números (margen, totales) Total: S/ {{ $json.precio * $json.cantidad }} // condición corta (si/no) {{ $json.pagado ? 'PAGADO ✅' : 'POR COBRAR ⚠️' }} // texto en mayúsculas / limpio {{ $json.zona.toUpperCase() }}

Variables especiales útiles

Variable	Qué trae
`$json`	El item actual (lo más usado).
`$now`	Fecha y hora de ahora.
`$node["Nombre"]`	Datos de otro nodo por su nombre.
`$items()`	Todos los items juntos (para contar, sumar, etc.).
`$vars`	Variables globales que definas.

Consejo de oro

No memorices nombres de campo. Arrastra el dato desde el panel izquierdo a la casilla y n8n escribe la expresión correcta por ti. Empieza siempre así; con el tiempo las escribes de memoria.

🧪 Probador en vivo — practica aquí mismo

Este es un pedido de ejemplo de Altoke Gas (el "item" que llega al nodo). Escribe una expresión abajo y mira el resultado al instante, igual que en n8n. Puedes editar el JSON también.

📦 Dato que llega ($json) — editable ✍️ Tu expresión (con las dobles llaves) ➡️ Resultado

insertar dato multiplicar condición sí/no fecha de hoy mayúsculas + defecto redondear

Tip: rompe cosas a propósito — escribe mal un nombre de campo y mira el error. Así aprendes a leerlos sin miedo.

CAPÍTULO 11

Credenciales: conectar apps

Para que n8n use tu Gmail, tu WhatsApp o tu OpenAI, necesita "llaves" de acceso. Eso son las credenciales. Se guardan una vez y se reutilizan en todos los flujos.

Tres formas típicas de conectar

Método	Cómo es
OAuth	Le das clic a "Conectar cuenta", se abre la ventana de Google/Facebook y aceptas. Lo más cómodo (Gmail, Sheets, Drive).
API Key	Copias una clave secreta desde la otra app (ej: OpenAI, Anthropic) y la pegas en n8n.
Header / Token	Para APIs propias (Firebase, WhatChimp, Evolution API): mandas un token en la cabecera del HTTP Request.

Dónde se guardan

En la sección Credentials. Un mismo acceso (ej: tu OpenAI) lo configuras una vez y todos tus nodos lo pueden usar. Si cambias la clave, la actualizas ahí y listo, no tocas los flujos.

Pantalla de crear credencial en n8n — **Crear una credencial**: eliges la app, pegas la llave (o das clic en "Conectar"), y listo.

Credencial de OpenAI con API key en n8n — **Ejemplo con API Key** (OpenAI/Claude): copias la clave desde su web y la pegas UNA vez. Cuando sale el check verde, quedó conectada.

FIG. 11 — Credentials: la caja fuerte central de tus llaves de acceso

Seguridad

Nunca pegues tus claves secretas dentro de un texto o de un nodo Code a la vista. Siempre van en Credentials (n8n las guarda encriptadas). Y nunca compartas un export del workflow con las credenciales dentro.

CAPÍTULO 12

Cuando algo falla (errores)

Los flujos fallan: se cae una API, llega un dato raro, se vence un token. Un buen operador no evita los errores, los maneja.

1 · Revisa la ejecución

Ve a Executions. Las fallidas salen en rojo. Ábrela y verás en qué nodo se rompió y con qué datos. El 90% de los problemas se resuelven mirando aquí.

Lista de ejecuciones en n8n con estados — **La lista de Executions**: cada corrida con su hora, duración y estado. Las rojas son las que fallaron.

Ejecución abierta mostrando los datos que pasaron por cada nodo — **Ejecución abierta**: ves el flujo tal como corrió, con los datos reales que pasaron por cada nodo. Tu herramienta de detective.

2 · Continue On Fail

En la configuración de un nodo puedes activar que, si falla, no se caiga todo el flujo sino que siga por una salida de "error". Útil cuando procesas muchos items y no quieres que uno malo tumbe a los demás.

3 · Retry (reintentar)

Muchos nodos permiten reintentar automáticamente X veces si falla (ideal para APIs que a veces no responden a la primera).

4 · Error Workflow

Puedes crear un flujo especial que se dispara cuando cualquier otro falla, y que te mande un WhatsApp o correo avisando: "Se cayó el flujo de reportes 🛑". Así te enteras al toque, no al día siguiente.

FIG. 12 — Un solo Error Workflow vigila TODOS tus flujos importantes

🛑

Error Trigger

algo falló

📲

Avisarme

WhatsApp/Telegram

Regla práctica

Todo flujo que corra solo y sea importante (reportes, cobros, avisos a clientes) debería tener un Error Workflow avisándote. Es 10 minutos de trabajo que te ahorra dolores de cabeza.

CAPÍTULO 13

IA dentro de n8n

Aquí está la joya. n8n trae un nodo AI Agent que convierte tus flujos en asistentes que piensan, deciden y usan herramientas. Es lo que hace a n8n mejor que Zapier para IA.

Diferencia clave: LLM vs Agente

Un LLM (Claude, GPT) solo responde texto. Le preguntas, te contesta.
Un Agente además hace cosas: decide qué herramienta usar, la usa (buscar en tu base, escribir en Sheets, mandar WhatsApp) y sigue hasta cumplir el objetivo.

Diagrama oficial de n8n comparando cadenas y agentes — **Del material oficial de n8n**: una cadena (chain) siempre sigue el mismo camino; un **agente decide** qué hacer según el caso. Por eso el agente puede atender clientes de verdad.

Las 4 piezas del AI Agent

FIG. 13 — Anatomía del AI Agent: cerebro + instrucciones + memoria + herramientas

Pieza	Qué es
Chat Model	El cerebro. Eliges el modelo: Claude, GPT-4o, Gemini, etc. (se conecta por debajo del nodo Agent).
System Prompt	Las instrucciones de personalidad y reglas ("eres el asistente de Altoke Gas, hablas casero cusqueño, solo hablas de gas...").
Memory	Para que recuerde la conversación. Opciones: en memoria, Redis, Postgres. Se guarda por sesión (por cliente).
Tools (herramientas)	Lo que el agente PUEDE hacer: consultar precios, revisar zona, registrar pedido. Cada tool es otro nodo o sub-flujo.

💬

Chat Trigger

cliente escribe

🧠

AI Agent

Claude + tools

📲

Responder

Nodo AI Agent en el lienzo de n8n con modelo y memoria conectados — **El AI Agent real en el lienzo**: fíjate cómo el Chat Model y la Memory se conectan POR DEBAJO del nodo — igual que en el diagrama de arriba.

Ventana de chat de prueba conversando con el agente en n8n — **Probándolo en el chat**: n8n trae una ventana de chat integrada para conversar con tu agente antes de conectarlo a WhatsApp.

Log del agente mostrando su razonamiento paso a paso — **El log del agente**: ves paso a paso qué pensó, qué herramienta usó y qué respondió. Cuando el bot "responda raro", aquí descubres por qué.

RAG en dos líneas

RAG = darle al agente tu propia información (tus precios, tus zonas, tus reglas) para que responda con datos tuyos y no invente. Se guarda en un "almacén de vectores" y el agente consulta ahí antes de responder. Para empezar no lo necesitas: con un buen System Prompt que incluya tus precios y zonas ya funciona muy bien.

Novedad 2026

El AI Agent ahora es más confiable: evita bucles infinitos, muestra su razonamiento paso a paso en el log, y permite pasos de aprobación humana (el agente pausa y espera tu "OK" antes de hacer algo delicado, como confirmar un pedido grande). Ideal para no perder el control.

Para Altoke Gas

Tu chatbot de WhatsApp con IA sería: Chat Trigger → AI Agent (con Claude + tus precios/zonas en el prompt + memoria por cliente) → responder por WhatChimp. Con tools puedes hacer que además registre el pedido en Firebase automáticamente.

CAPÍTULO 14

Integraciones clave

Estas son las conexiones que más vas a usar en un negocio como el tuyo, con la forma práctica de hacerlas.

Hay tres caminos según lo que uses:

Con WhatChimp / plataforma de bot: normalmente ellos te dan un webhook y una API. Recibes mensajes con el nodo Webhook y respondes con HTTP Request.
Evolution API / API no oficial: igual, Webhook para recibir + HTTP Request para enviar.
WhatsApp Business API oficial (Meta): n8n tiene nodo dedicado; requiere aprobación de Meta.

FIG. 14 — La arquitectura de tu WhatsApp: casero ↔ WhatChimp ↔ n8n ↔ Firebase

El más fácil para empezar y para tus avisos internos. Creas un bot con @BotFather, pegas el token en n8n y ya envías/recibes. Perfecto para "avísame cuando pase X".

Google Sheets

Conexión por OAuth (un clic). Sirve para llevar registros, listas de clientes, control de stock ligero. Acciones: agregar fila, leer, actualizar, buscar.

OpenAI / Anthropic (Claude)

Pegas tu API Key en Credentials. Úsalos para generar textos de Facebook, respuestas de chatbot, resúmenes, ideas de contenido. En el AI Agent eliges cuál modelo es el "cerebro".

Firebase

No siempre hay nodo directo, pero con HTTP Request a la API REST de Firebase (Realtime Database o Firestore) lees y escribes sin problema. Así conectas tu sistema V7 con tus flujos.

Facebook / redes

Para publicar automático: generas texto+imagen con IA y publicas vía HTTP Request a la API de la red, o con nodos dedicados donde existan. Encaja perfecto con tu agente de contenido.

La regla universal

Si una app tiene API (casi todas la tienen), la conectas con HTTP Request aunque no exista un nodo específico. Aprender bien HTTP Request te abre el 100% de las integraciones.

CAPÍTULO 15

4 flujos para Altoke Gas

Ideas concretas que puedes construir con lo aprendido. De la más simple a la más avanzada.

Flujo 1 · Reporte de cierre diario

⏰

10 pm

Schedule

🔥

Leer ventas

Firebase

Sumar / resumir

Aggregate

📲

Enviar resumen

Cada noche lee las ventas del día en Firebase, calcula total vendido, ganancia y cobros pendientes, y te lo manda por WhatsApp. Reemplaza el trabajo manual de cierre.

Flujo 2 · Recordatorio de recarga

Sabemos que un cliente que compró hace ~30 días probablemente ya está por quedarse sin gas. El flujo revisa tu base, encuentra a esos clientes y les manda un WhatsApp amable: "Casero/a, ¿ya va quedando bajo el balón? Te lo dejamos al toque 🛵". Retención pura, en automático.

Flujo 3 · Chatbot de pedidos con IA

💬

Msj cliente

Webhook

🧠

AI Agent

Claude

🔥

Registrar pedido

Firebase (tool)

📲

Confirmar

Atiende 24/7: saluda casero, da precios de Vitagas/Limagas/Solgas, pregunta zona, arma el pedido, lo guarda en Firebase y confirma. Tú solo despachas.

FIG. 15 — El chatbot de pedidos de Altoke Gas: cada pieza en su lugar

Flujo 4 · Contenido de Facebook automático

A una hora fija, un agente genera el texto persuasivo (tono cusqueño, promo del plato de loza gratis, tus dos números de WhatsApp) y una imagen con IA según tus reglas de marca (balón azul, uniforme azul con franjas rojas), y lo deja listo para publicar. Tu agente de contenido, pero orquestado en n8n.

Por dónde empezar

Arranca por el Flujo 1 (reporte diario): es el más simple, te da un resultado útil rápido y practicas Schedule + leer datos + enviar mensaje. Cuando lo domines, subes al chatbot con IA.

CAPÍTULO 16

Buenas prácticas

Costumbres que separan a un flujo que aguanta en producción de uno que se rompe cada semana.

Nombra tus nodos. No dejes "HTTP Request 3". Ponle "Enviar WhatsApp confirmación". Te salvará al depurar.
Un flujo, una tarea. Si crece mucho, pártelo en sub-flujos que se llaman entre sí.
Prueba con datos reales antes de activar. Usa el Manual Trigger para ensayar.
Pon Error Workflows en todo lo importante que corra solo.
No repitas trabajo: si algo se usa en 3 flujos, hazlo sub-flujo reutilizable.
Guarda versiones. Antes de un cambio grande, exporta el workflow a JSON como respaldo.
Cuida el gasto de IA: filtra datos antes de mandarlos al modelo y usa modelos más baratos para tareas simples.
Documenta con Sticky Notes. n8n tiene notas adhesivas en el lienzo: escribe qué hace cada parte para tu "yo" del futuro.

CAPÍTULO 17

Errores típicos de principiante

Los tropiezos clásicos. Reconocerlos te ahorra horas.

Problema	Causa / solución
"No me llega el dato"	Nombre de campo mal escrito o el nodo anterior no lo produjo. Revisa la salida anterior y arrastra el campo.
El flujo no corre solo	Olvidaste subir el interruptor Active, o estás usando Manual Trigger (ese solo corre al probar).
El Webhook no recibe nada	Estás usando la URL de test en vez de la de producción, o el flujo no está activo.
Se ejecuta muchas veces	Recuerda: si entran 5 items, el nodo corre 5 veces. Usa Aggregate o Loop si quieres controlarlo.
Credencial "unauthorized"	La clave venció o está mal. Reconéctala en Credentials.
La IA da bucles o se cuelga	Falta cerrar bien las tools o el prompt es ambiguo. Sé específico en el System Prompt.
Todo se cae por un item malo	Activa Continue On Fail en ese nodo.

CAPÍTULO 18

Glosario rápido

Workflow	Tu automatización completa (el mapa de nodos).
Nodo	Cajita que hace una tarea.
Trigger	Nodo que arranca el flujo.
Webhook	URL que recibe datos de otras apps.
Item	Paquetito de datos (JSON) que viaja entre nodos.
JSON	Formato de datos en pares nombre: valor.
Expresión	Código dinámico entre `{{ }}` para insertar datos.
Ejecución	Una corrida del flujo (queda en el historial).
Credencial	Llave guardada para acceder a una app.
AI Agent	Nodo de IA que piensa, decide y usa herramientas.
Tool	Herramienta que el agente puede usar (buscar, escribir, enviar).
RAG	Darle al agente tu propia info para que responda con tus datos.
Self-hosted	n8n instalado en tu propio servidor.
Sub-flujo	Un workflow que otro workflow llama, como una función.

CAPÍTULO 19

Tu ruta de aprendizaje

Un plan realista de ~3 semanas practicando poquito cada día, con proyectos reales de tu negocio.

FIG. 16 — Tu línea de tiempo: 5 etapas, cada una con entregable real

Días 1–3 · Fundamentos
Crea cuenta en n8n Cloud (prueba de 14 días) o instala en tu VPS. Haz el Curso oficial Nivel 1 (gratis, 2 horas — cap. 21). Arma el flujo del cap. 7. Objetivo: perderle el miedo al lienzo y ganar tu primera insignia.
Días 4–7 · Datos y lógica
Haz el Curso oficial Nivel 2 (gratis, 2 horas). Practica IF, Switch y Filter. Conecta Google Sheets. Refuerza con un curso en español de YouTube (cap. 22) a 1.5x, construyendo en paralelo.
Días 8–12 · Integraciones
Domina HTTP Request y Webhook. Conecta Telegram (fácil) y luego tu WhatsApp real. Construye el Flujo 1: reporte diario partiendo del JSON del Anexo F.
Días 13–17 · IA
Importa la plantilla "Building your first WhatsApp chatbot" (cap. 23), estúdiala con el método de 4 pasos, y cámbiale el prompt por el del Anexo E. Mira la serie oficial "Building AI Agents" en YouTube.
Días 18–21 · Producción
Agrega Error Workflows, memoria por cliente y registro en Firebase. Consolida en tu VPS con zona horaria de Lima. Construye el Flujo 3: chatbot de pedidos completo. Ya eres operador de n8n. 🚀

Cómo estudiar de verdad

No veas 10 tutoriales seguidos. Construye. Elige un problema real de Altoke Gas cada pocos días y resuélvelo en n8n. Y cuando te trabes, usa la técnica del cap. 24: pégame el error y lo destrabamos en minutos, no en horas.

CAPÍTULO 20

Recursos

Documentación oficial — docs.n8n.io. Clarísima, con ejemplos de cada nodo.
Plantillas — n8n.io/workflows. Miles de flujos ya hechos que puedes copiar y adaptar. Empieza siempre buscando aquí antes de armar de cero.
Comunidad — el foro oficial y su comunidad (+200 mil personas) responden dudas rápido.
YouTube — busca la serie oficial "Building AI Agents" de n8n para el nodo AI Agent.
Tu mejor recurso: yo. Cuando te trabes en un flujo, pégame el error o descríbeme qué quieres lograr y lo resolvemos juntos, paso a paso.

Siguiente paso sugerido

Dime cuál de los 4 flujos de Altoke Gas quieres construir primero y te armo el paso a paso detallado, nodo por nodo, con las configuraciones exactas listas para copiar.

🚀 Parte 2 · Acelerador

Todo lo mejor que existe en Internet para aprender n8n rápido — cursos oficiales gratis, canales en español, bibliotecas de plantillas, costos reales de hosting y trucos de la comunidad — filtrado y ordenado para que no pierdas ni un día buscando.

CAPÍTULO 21

La ruta oficial GRATIS (n8n Academy)

Poca gente lo sabe: n8n tiene cursos oficiales gratuitos con insignia de certificación. Son la forma más ordenada de aprender, hechos por los propios creadores, y cada uno toma solo ~2 horas.

Curso Nivel 1 · Fundamentos (gratis, ~2 horas)

En docs.n8n.io/courses/level-one. Aprendes a navegar el editor, cómo n8n estructura los datos, configurar nodos y credenciales. Construyes 2 workflows reales guiados paso a paso. Te registras, te dan un ID único, y al completar los hitos ganas una insignia oficial que puedes mostrar en tu perfil (útil si algún día vendes automatizaciones).

Curso Nivel 2 · Datos y lógica avanzada (gratis, ~2 horas)

En docs.n8n.io/courses/level-two. Es EL curso que te vuelve peligroso: estructura de datos a fondo, procesar distintos tipos (fechas, HTML, binarios), combinar datos de varias fuentes (base de datos + hoja de cálculo + CRM — exactamente lo que haces con Firebase) y usar JavaScript en el nodo Code. También da insignia.

n8n Academy · cursos interactivos nuevos

En learn.n8n.io lanzaron una academia con cursos interactivos como N8N101 Essentials: Your First Workflows y N8N102 Integrations: APIs & Connected Workflows, con certificados de finalización. Están en inglés, pero son muy visuales — y si te trabas con el idioma, me pegas el texto y te lo traduzco al toque.

Serie oficial en YouTube "Building AI Agents"

La serie del canal oficial de n8n donde Max te enseña a construir agentes de IA desde cero: Chat Trigger, memoria, prompts efectivos y cómo compartir tu agente. Es la mejor introducción en video al nodo AI Agent.

Mi jugada recomendada

Haz el Nivel 1 este fin de semana (2 horas) y el Nivel 2 el siguiente. Con 4 horas totales tienes la base oficial completa + 2 insignias. Todo lo demás de este manual se te hará el doble de fácil.

CAPÍTULO 22

Los mejores recursos en español

No necesitas pelear con el inglés. Hay un ecosistema en español bastante bueno. Esto es lo mejor filtrado.

Comunidades en español (gratis)

Comunidad n8n en Español — el grupo de Telegram t.me/comunidadn8n y su web comunidad-n8n.com con tutoriales en español. Preguntas ahí y te responden hispanohablantes que ya pasaron por tus mismos trancazos.
Aprende n8n (aprenden8n.com) — formación en español para usuarios NO técnicos, de Miquel Colomer, coadministrador de la comunidad hispana. Enfocado justo en gente como tú: operadores de negocio, no programadores.
Foro oficial (community.n8n.io) — en inglés pero con sección activa de hispanohablantes. Cuando un error te tranca, búscalo ahí: casi seguro alguien ya lo resolvió.

Cursos completos gratis en YouTube (español)

Busca en YouTube estos títulos — son cursos completos de varias horas, gratis, actualizados a 2025/2026:

"Curso de N8N desde CERO (completo)" — cubre desde entender n8n y flujo de datos hasta agentes de IA. Ideal como columna vertebral de tu aprendizaje en video.
"Curso Completo de n8n: Automatizaciones con IA" — enfocado en armar tu primera automatización real paso a paso, sin enredos.
"N8N para Principiantes" — serie por aulas que incluye justo tus temas: chatbot en WhatsApp, credenciales de Google, webhooks de principiante a experto, sub-workflows y multi-agentes de marketing.
"Curso Completo de N8N: de Cero a Experto en Español" — playlist para crear automatizaciones, conectar APIs y agentes de IA.

Cómo ver tutoriales sin perder tiempo

Regla del 2x1: por cada hora de video, una hora construyendo tú mismo lo que viste, pero aplicado a Altoke Gas. Ver sin hacer = olvidar en 3 días. Y ponlos a velocidad 1.5x — se entienden igual.

CAPÍTULO 23

Plantillas: el atajo maestro

El secreto peor guardado de los que aprenden rápido: casi nunca construyen de cero. Importan una plantilla que ya funciona, la abren, la estudian y la adaptan. Aquí están las mejores bibliotecas.

1 · Biblioteca oficial: n8n.io/workflows

Miles de flujos gratis, listos para importar con un clic. Antes de construir CUALQUIER cosa, busca ahí primero. Plantillas que te sirven directo:

"Building your first WhatsApp chatbot" — chatbot de ventas con IA que responde consultas usando un catálogo de productos como base de conocimiento. Es literalmente la base de tu bot de pedidos de gas.
"WhatsApp Starter Workflow" — el esqueleto mínimo para recibir y responder mensajes de WhatsApp. Perfecto para entender la mecánica.
Chatbot multimodal de WhatsApp — versión avanzada que entiende texto, audios (los transcribe), imágenes y PDFs, con memoria. Cuando tu bot básico funcione, este es el siguiente nivel: tus caseros que mandan audios también serían atendidos.

2 · GitHub: awesome-n8n-templates

La colección open-source más grande: +280 plantillas gratis organizadas por app — Gmail, Telegram, WhatsApp, Google Drive, OpenAI, agentes RAG, redes sociales y más. Búscalo en GitHub como enescingoz/awesome-n8n-templates. Incluye una sección completa de automatización de WhatsApp para negocios.

3 · Cómo estudiar una plantilla (el método)

FIG. 17 — El método de 4 pasos: así aprenden los que aprenden rápido

Impórtala y NO la toques todavía
Ábrela y recorre nodo por nodo. Pregúntate: ¿qué hace este? ¿por qué está aquí?
Ejecuta y mira los datos
Corre el flujo y abre cada nodo para ver qué entró y qué salió. Ahí está el verdadero aprendizaje.
Rompe una cosa a propósito
Cambia un campo, borra una conexión, mira qué error da. Aprender a leer errores en un flujo ajeno es entrenamiento en modo seguro.
Adáptala a tu negocio
Cambia los textos al tono casero, conecta tus credenciales, apunta a tu Firebase. Ahora es TUYA y entendiste cada pieza.

Tu atajo específico

Importa "Building your first WhatsApp chatbot" de n8n.io/workflows esta semana. Cámbiale el catálogo por tus 3 marcas de balones y el prompt por el del Anexo E. En un par de tardes tienes un prototipo real de tu bot de pedidos.

CAPÍTULO 24

Claude como tu profesor de n8n

Este es tu arma secreta y casi nadie la explota bien: puedes usarme (Claude) como profesor particular, generador de flujos y depurador de errores, 24/7. Así se acelera de verdad.

Técnica 1 · Pídeme workflows en JSON listos para importar

Los workflows de n8n se exportan e importan como JSON. Eso significa que yo puedo escribirte flujos completos que pegas directo en tu n8n (Ctrl+V sobre el lienzo, o Import from File). Ya lo probaste con el demo del Anexo F. Prompt listo para copiar:

Genera un workflow de n8n en formato JSON válido para importar. Debe hacer: [DESCRIBE QUÉ QUIERES, ej: "cada lunes 8am leer mi Google Sheet de clientes, filtrar los que compraron hace más de 28 días y mandarme la lista por Telegram"]. Usa nombres de nodos en español descriptivos. Si necesita credenciales, deja los nodos configurados pero indícame en una lista qué debo conectar yo. Explica brevemente cada nodo al final.

Técnica 2 · Pégame el error tal cual

Cuando un nodo falle, copia el mensaje de error completo (o mándame captura de pantalla — también leo imágenes) y dime qué intentabas hacer. Te digo la causa y el arreglo exacto. Es como tener soporte técnico personal.

Técnica 3 · Pégame un workflow para que te lo explique

¿Descargaste una plantilla y no entiendes qué hace? Selecciona todos los nodos en n8n, Ctrl+C, y pégame ese JSON aquí. Te explico nodo por nodo en cristiano qué hace y cómo adaptarlo a Altoke Gas.

Técnica 4 · El AI Assistant dentro del propio n8n

n8n trae su propio asistente de IA integrado en el editor que ayuda a construir y corregir flujos desde adentro. Úsalo para lo rápido, y a mí para lo estratégico y lo complejo (diseñar el flujo completo, el prompt del agente, la lógica de negocio).

Técnica 5 · Diseño antes de construir

Antes de arrastrar un solo nodo, descríbeme el proceso de tu negocio y pídeme el diseño: "Quiero automatizar X, ¿qué nodos usarías y en qué orden?" Te devuelvo el mapa. Construir con plano es 3 veces más rápido que a ciegas.

Por qué esto cambia todo

El que aprende solo se traba horas con cada error. El que aprende con IA se traba minutos. Tu velocidad de aprendizaje ya no depende de cuánto sabes, sino de qué tan bien preguntas. Y preguntar bien ya lo sabes hacer.

CAPÍTULO 25

Hosting: costos reales 2026

Datos frescos para que decidas con números en la mano y no pagues de más.

Lo que cuesta cada opción hoy

Opción	Costo aprox.	Para quién
n8n Cloud Starter	~US$20–24/mes, con tope de ~2,500 ejecuciones/mes; prueba gratis de 14 días (ya no hay plan gratis permanente)	Probar sin tocar servidores
VPS con plantilla n8n (Hostinger)	~US$5–7/mes con n8n preinstalado en un clic, ejecuciones ilimitadas	El punto dulce para negocios como el tuyo
VPS pelado (Hetzner, Contabo)	~US$4–5/mes, pero tú instalas Docker, SSL, todo	Si te gusta meterle mano al servidor
Hosting gestionado especializado	Desde ~US$3/mes con actualizaciones y SSL incluidos	Barato y sin mantenimiento

Requisitos del servidor (para que no se arrastre)

Mínimo real: 1 vCPU, 2 GB de RAM y 20 GB SSD. Recomendado para un negocio con flujos corriendo todo el día: 2 vCPU y 4 GB de RAM. Con eso corres tu chatbot, reportes y contenido sin que se atore.

El detalle que casi todos olvidan: la zona horaria

Al configurar tu instancia, define la variable GENERIC_TIMEZONE=America/Lima. Si no, tu "reporte de las 10 pm" saldrá en hora de Alemania y te volverás loco pensando que el Schedule está roto.

FIG. 18 — Las 3 opciones de hosting frente a frente

La cuenta que importa

Un chatbot de WhatsApp activo genera miles de ejecuciones al mes (cada mensaje = ejecuciones). En Cloud eso te empuja rápido a planes caros; el tope se alcanza y tus flujos se detienen. En un VPS de ~US$6/mes corres ilimitado. Para tu caso, el VPS gana lejos.

CAPÍTULO 26

Trucos pro de la comunidad

Técnicas que los veteranos usan a diario y que los tutoriales básicos no cuentan.

1 · Pin de datos = desarrollo gratis

El truco #1 de los pros: cuando un nodo llama a algo caro o lento (la IA, una API de imágenes), corre una vez, fija su salida (pin) y construye todo lo que sigue usando esos datos congelados. Ajustas, pruebas y repruebas sin gastar ni un centavo más en llamadas. Al terminar, desfijas.

2 · Copia nodos entre workflows (y hacia mí)

Selecciona nodos, Ctrl+C, y pégalos en otro workflow — o pégalos en un chat conmigo como texto. Los nodos SON texto JSON. Esto te permite reutilizar piezas y compartir flujos como si fueran mensajes.

3 · Sub-workflows = piezas de Lego

¿"Enviar WhatsApp" aparece en 4 flujos distintos? Hazlo UN sub-workflow (con el trigger "Execute Workflow") y llámalo desde los demás. Si mañana cambias de WhatChimp a otra API, corriges en UN solo lugar.

4 · Sticky Notes con colores

Documenta el lienzo con notas adhesivas de colores por sección: verde = entrada, amarillo = lógica, rosado = salida. Cuando vuelvas a un flujo en 3 meses, te lo agradecerás.

5 · El workflow se conoce a sí mismo

Con expresiones como {{ $workflow.name }} y {{ $execution.id }} tu flujo puede reportar quién es y qué corrida falló. Úsalo en tus avisos de error: "Falló [nombre del flujo], ejecución [id]" — y depuras en segundos.

6 · Webhook: test vs producción

Cada Webhook tiene DOS URLs. La de Test solo funciona mientras tienes el editor abierto escuchando; la de Producción funciona cuando el flujo está activo. El 80% de los "no me llega nada" es por usar la URL equivocada. Grábatelo.

FIG. 19 — Las dos URLs del Webhook: el error #1 de los que empiezan

Nodo Webhook de n8n mostrando la pestaña de Test URL y Production URL — **Así se ven en el nodo real**: dos pestañas, Test URL y Production URL. Antes de pegar la URL en WhatChimp, revisa DOS veces qué pestaña tienes seleccionada.

7 · Ejecuta desde un nodo intermedio

No necesitas correr todo el flujo cada vez. Puedes ejecutar "hasta aquí" o reejecutar solo desde el nodo que cambiaste. Combinado con el pin de datos, iterar es rapidísimo.

8 · Exporta respaldos cada viernes

Menú → Download. Un JSON por workflow importante, guardado en tu Drive. Si algo se corrompe o borras sin querer, restauras en 1 minuto. Los pros no confían, respaldan.

CAPÍTULO 27

Monetiza: vende automatización

Bonus estratégico: lo que aprendas aquí no solo optimiza Altoke Gas — es una habilidad que se vende. La automatización con n8n + IA es de los servicios más demandados ahora mismo.

Tu ventaja injusta

Los "expertos en automatización" que cobran caro casi nunca han operado un negocio real. Tú sí: conoces pedidos, cobros, reparto, clientes que no pagan. Cuando le digas a otro negocio "yo automaticé el mío, mira", eso vende más que cualquier certificado.

La escalera de monetización

FIG. 20 — La escalera: de operador de gas a operador de automatización

Automatiza Altoke Gas al 100%
Tu propio negocio es tu laboratorio y tu portafolio. Cada flujo que funcione es un caso de éxito demostrable.
Vende el mismo flujo a negocios similares
Distribuidoras de gas, agua, delivery de comida en Cusco. El chatbot de pedidos que armaste para ti les sirve casi igual. Cobra instalación (S/ 500–1,500) + mensualidad de mantenimiento (S/ 100–300).
Licencia tu sistema V7 + automatizaciones
El plan que ya tienes en mente: V7 + chatbot + reportes como paquete para otras distribuidoras de gas del Perú. n8n es el pegamento que lo hace producto.
Agencia de automatización local
Cuando tengas 3–4 clientes, ya tienes un segundo negocio con ingresos recurrentes que atiendes desde tu celular.

Qué venderle primero a un negocio local

Chatbot de WhatsApp que atiende y toma pedidos — el más pedido y el que mejor se cobra.
Recordatorios automáticos de recompra — fácil de armar, impacto directo en ventas del cliente.
Reporte diario de ventas al dueño — barato de hacer, los dueños lo aman.

Jugada concreta

Cuando tu chatbot de Altoke Gas lleve 1 mes funcionando, graba un video de 60 segundos mostrándolo en acción y súbelo a tu Facebook: "Así atiende mi negocio solo, 24/7. ¿Quieres lo mismo para el tuyo? Escríbeme." Costo: cero. Es tu primer anuncio de tu segundo negocio.

◆ Anexos prácticos ◆

La parte de "copiar y usar". Referencia rápida, recetas de código, horarios, un System Prompt listo para tu chatbot y un flujo real que puedes importar de una.

ANEXO A

Chuleta de expresiones

Las que usarás el 95% del tiempo. Copia, pega y cambia los nombres de campo.

Quiero…	Escribo
Insertar un dato	`{{ $json.cliente }}`
Fecha de hoy	`{{ $now.format('dd/MM/yyyy') }}`
Hora actual	`{{ $now.format('HH:mm') }}`
Sumar / multiplicar	`{{ $json.precio * $json.cantidad }}`
Sí / no según condición	`{{ $json.pagado ? 'PAGADO' : 'POR COBRAR' }}`
Poner en mayúsculas	`{{ $json.zona.toUpperCase() }}`
Redondear un número	`{{ Math.round($json.total) }}`
Valor por defecto si está vacío	`{{ $json.nombre \|\| 'casero' }}`
Contar cuántos items hay	`{{ $items().length }}`
Dato de otro nodo por nombre	`{{ $node["Webhook"].json.telefono }}`
Recortar texto (primeros 50)	`{{ $json.mensaje.slice(0, 50) }}`
Reemplazar texto	`{{ $json.zona.replace('San ', '') }}`

Recuerda

Todo lo que va dentro de {{ }} es JavaScript. Si dudas de un nombre de campo, arrástralo desde el panel izquierdo y n8n lo escribe bien por ti.

ANEXO B

Atajos de teclado

Los que te hacen construir el doble de rápido. (Pueden variar un poco según versión.)

Atajo	Hace
`Tab`	Abrir el buscador de nodos
`Ctrl / Cmd + S`	Guardar el workflow
`Ctrl / Cmd + C · V`	Copiar y pegar nodos (¡incluso entre workflows!)
`Ctrl / Cmd + Z`	Deshacer
`Supr / Backspace`	Borrar el nodo seleccionado
`F2`	Renombrar el nodo seleccionado
`D`	Activar / desactivar un nodo (para probar sin él)
`P`	Fijar datos (pin) para probar sin volver a llamar la API
`1` · `0`	Ajustar zoom a la vista / al 100%
Scroll · pinza	Zoom in/out en el lienzo
Arrastrar el lienzo	Moverte por el mapa

El más subestimado: Pin (P)

Cuando pruebas un flujo que llama a una API o a la IA, "fijar datos" congela la respuesta para que no gastes llamadas (ni plata) cada vez que corres. Fíjalo, construye tranquilo, y lo desfijas al final.

ANEXO C

Recetas del nodo Code

Cuando ningún nodo hace justo lo que quieres, el nodo Code (JavaScript) te salva. Aquí 3 recetas listas para tu negocio.

1 · Juntar varios items en un solo texto (para reportes o listas)

// arma una lista tipo "• Rosa — Tica Tica" const lineas = $input.all().map(i => `• ${i.json.cliente} — ${i.json.zona}`); return [{ json: { lista: lineas.join('\n'), total: lineas.length } }];

2 · Normalizar teléfono peruano y armar el link de WhatsApp

// limpia el número y crea el enlace wa.me const raw = ($json.telefono || '').toString().replace(/\D/g, ''); const num = raw.startsWith('51') ? raw : '51' + raw; return [{ json: { ...$json, wa: `https://wa.me/${num}` } }];

3 · Clientes que compraron hace +28 días (candidatos a recarga)

// deja pasar solo a los que ya deberían estar por quedarse sin gas const hoy = new Date(); return $input.all().filter(i => { const dias = (hoy - new Date(i.json.ultimaCompra)) / 86400000; return dias >= 28; });

Regla

El nodo Code siempre debe devolver una lista de items (un array con objetos { json: {...} }). Si te da error, casi siempre es porque olvidaste el return o no devolviste ese formato.

ANEXO D

Horarios (Schedule / cron)

Cómo decirle al nodo Schedule cuándo correr. Para lo simple usas el modo "Interval"; para lo fino, "Cron".

Nodo Schedule Trigger configurado en n8n — **El Schedule Trigger real**: eliges el intervalo (días, horas, minutos) y la hora exacta. Lo que configures aquí decide cuándo despierta tu flujo.

Quiero que corra…	Config
Cada día a las 10 pm	Interval → Days, hora `22:00`
Cada hora	Interval → Hours, cada `1`
Cada 15 minutos	Interval → Minutes, cada `15`
Lunes a viernes 8 am	Cron → `0 8 * * 1-5`
El día 1 de cada mes, 9 am	Cron → `0 9 1 * *`
Sábados 7 pm	Cron → `0 19 * * 6`

Cómo leer el cron

Son 5 casillas separadas por espacio: minuto hora díaDelMes mes díaDeSemana. Un * significa "todos". En día de semana, 1 = lunes … 7 = domingo.

Ojo con la zona horaria

Asegúrate de que tu n8n esté en hora de Perú (America/Lima) o el reporte de las 10 pm te llegará a otra hora. Se ajusta en la configuración de la instancia o del propio nodo Schedule.

⏰ Armador de cron — elige y copia

Elige cuándo quieres que corra y te doy el cron listo para pegar en el nodo Schedule.

Frecuencia

A qué hora

0 22 * * *

ANEXO E

System Prompt para tu chatbot

Este es el "cerebro" de tu AI Agent: pégalo en el campo System Prompt. Solo llena lo que está entre [corchetes] con tus precios y zonas.

# ROL Eres el asistente virtual de Altoke Gas, negocio de venta y reparto de balones de gas de 10kg en Cusco. Atiendes por WhatsApp. Tu única función es ayudar a vender gas y coordinar entregas. # TONO - Español peruano informal y cusqueño, cálido y cercano. - Usa "casero/a", "causa", "al toque" con naturalidad, sin exagerar. - Mensajes cortos y claros: máximo 4-5 líneas. - 1-2 emojis relevantes por mensaje (🛵 🔵 🔥), nunca más. # QUÉ VENDES - Balones de gas de 10kg. Marcas: Vitagas, Limagas y Solgas. - Reparto en moto a domicilio y a negocios. # PRECIOS (usa SOLO estos, no inventes) - Vitagas 10kg: S/ [PRECIO] - Limagas 10kg: S/ [PRECIO] - Solgas 10kg: S/ [PRECIO] # PROMO ACTIVA - Por cada balón: plato de loza GRATIS 🎁. Menciónalo al cerrar el pedido. # CÓMO ATENDER UN PEDIDO 1. Saluda casero y pregunta marca y cuántos balones. 2. Pide su zona/dirección y una referencia. 3. Confirma: marca, cantidad, total y zona. 4. Recuérdale la promo del plato de loza. 5. Indica que el motorizado va en camino 🛵 y el tiempo aprox. # ZONAS Repartimos en [LISTA DE ZONAS]. Si la zona no está cubierta, discúlpate amable y toma sus datos por si se amplía. # REGLAS - NO hables de temas ajenos al gas. Redirige con amabilidad. - NO inventes precios, promos ni tiempos. Si no sabes, dilo. - NO pidas datos sensibles. El pago es contra entrega. - Si quiere hablar con una persona, comparte: 📲 https://wa.me/51925444444 📲 https://wa.me/51925000000 # OBJETIVO Cerrar la venta rápido, generar confianza y dejar al cliente contento para que vuelva a pedir.

Cómo mejorarlo

Cuando lo pruebes, si el bot responde algo raro, vuelve al prompt y agrega una regla que lo corrija. Un buen System Prompt se afina con el uso: 20 minutos de ajustes valen más que mil tutoriales.

ANEXO F

Flujo listo para importar

Te dejé un workflow real de ejemplo (el reporte diario) que puedes meter a tu n8n de una y correrlo al instante, sin configurar nada.

▶

Probar

Manual Trigger

✎

Datos ejemplo

Code

{}

Armar reporte

Code

Cómo importarlo

Descarga el archivo
Con el botón de aquí arriba. Se guarda como altoke-reporte-demo.json en tus Descargas.
En n8n: menú (···) → Import from File
Elige el archivo. Aparecerá el flujo armado en tu lienzo.
Dale a "Test workflow"
Corre al toque y verás en el último nodo el texto del cierre diario ya formateado.
Hazlo tuyo
Cambia el nodo "Datos ejemplo" para que lea de Firebase, y el final para que envíe por WhatsApp. Ya tienes el Flujo 1 del cap. 15 funcionando.

Menú de n8n mostrando la opción Import from File — **Aquí está el menú**: los tres puntitos (···) arriba a la derecha del editor → **Import from File…** → eliges el JSON y el flujo aparece armado.

Por qué empezar así

Importar un flujo que ya funciona y luego modificarlo es la forma más rápida de aprender. Toca cada nodo, rómpelo, arréglalo. En una tarde entiendes más que leyendo una semana.