Chatbots de WhatsApp desde cero
Aprende a crear un bot de WhatsApp para cualquier negocio: del primer mensaje en consola a un bot real en la nube con pedidos, recordatorios y marketing responsable. Todo con un minimarket como proyecto guía.
Empezar la lección 1 Ver el temarioDel cero al bot real
Empiezas en tu consola, sin cuentas ni tarjetas, y terminas con un bot conectado a WhatsApp.
Un proyecto de verdad
Un minimarket: catálogo, carrito, pedidos, delivery, recordatorios y promociones.
Ejercicios que se comprueban
Funciones de JavaScript que revisa tu navegador y práctica real en tu computadora.
Hecho para el mundo real
Costos por mensaje, plantillas, permisos, privacidad y cómo no ser bloqueado.
Antes de empezar
- Saber JavaScript básico (variables, funciones, arrays y objetos). Si no, haz primero el curso de JavaScript.
- Una computadora con Node.js instalado (la lección 3 te guía).
- Un celular con WhatsApp para probar al final. Hasta el módulo 4 no necesitas ni eso.
Lo que construirás
- Un motor de conversación con menús, estado y lenguaje natural básico.
- Un servidor con webhook desplegado en la nube, gratis.
- Un bot conectado a la API oficial de WhatsApp que recibe y envía mensajes.
- Recordatorios y seguimiento automáticos con plantillas.
- Las bases para vender bots a negocios: costos, privacidad y alcance.
🧪 ¿Qué es el simulador?
Es un WhatsApp de práctica que corre en tu navegador con el mismo motor del bot del curso. No necesita cuenta de Meta, ni internet, ni dinero: escribes, tocas botones y ves el JSON que viajaría por la API.
- Es opcional: el curso se puede seguir con la terminal (
consola.js), pero el simulador es más visual para las lecciones 5 a 8 y el proyecto. - Pruébalo con los guiones guiados: hacer un pedido, cerrar la ventana de 24 h, escribir algo que no entiende.
- Mira el JSON para entender qué envía y recibe tu webhook.
Temario · ≈ 30 horas
- 1
Fundamentos
Qué es un bot de WhatsApp, qué puede hacer y cómo se diseña antes de programarlo.
-
LECCIÓN 01
Cómo funciona un bot de WhatsApp
Qué es un bot de WhatsApp, qué piezas lo forman, qué diferencia a la API oficial de las apps no oficiales y qué reglas impone Meta.
Disponible -
LECCIÓN 02
Diseñar la conversación antes de programar
Define qué hará y qué no hará tu bot, su tono, sus flujos y estados, los límites de los mensajes interactivos y cómo pasar a una persona.
Disponible - 2
Herramientas
Lo mínimo de JavaScript y Node para construir un bot, y tu primer bot en la terminal.
-
LECCIÓN 03
JavaScript y Node.js para bots
Instala Node, aprende a usar la terminal y repasa solo el JavaScript que necesita un bot: arrays, funciones puras, async/await, JSON, fetch y pruebas.
Disponible -
LECCIÓN 04
Tu primer bot en la consola
Construye un bot funcional en la terminal con readline, separa el cerebro de la entrada y salida, y escribe su primera prueba automática.
Disponible - 3
Motor de reglas
El cerebro del bot: estado, texto libre, catálogo, carrito y pedido completo.
-
LECCIÓN 05
El estado de la conversación
Cómo un bot recuerda en qué punto va cada cliente con una sesión y una máquina de estados, y por qué su cerebro debe ser una función pura.
Disponible -
LECCIÓN 06
Entender texto libre
Cómo un bot de reglas entiende frases como «quiero dos leches» con normalización, cantidades, sinónimos, tolerancia a errores de tipeo e intenciones, sin usar IA.
Disponible -
LECCIÓN 07
Catálogo y carrito
Modela el catálogo del minimarket como datos, respeta los límites de botones y listas de WhatsApp y construye un carrito puro e inmutable que suma en céntimos.
Disponible -
LECCIÓN 08
Flujo de pedido
Cierra el pedido de punta a punta, con entrega o recojo, mínimo de delivery, dirección, pago y confirmación, y aprende a probar todo el recorrido.
Disponible - 4
Servidor y webhook
Pasar de la terminal a un servidor que recibe mensajes por HTTP y vive en la nube.
-
LECCIÓN 09
Webhooks y JSON de WhatsApp
Cómo Meta te entrega los mensajes: forma del JSON, parser que lo convierte en eventos simples, verificación GET del webhook y firma HMAC-SHA256.
Disponible -
LECCIÓN 10
El servidor del bot
Cómo un Cloudflare Worker une webhook, motor y KV: rutas, firma, idempotencia, respuesta rápida con ctx.waitUntil y pruebas locales con wrangler dev.
Disponible -
LECCIÓN 11
Despliegue en Cloudflare
Publicar el bot en Cloudflare Workers paso a paso: cuenta, Wrangler, KV, secretos, wrangler.toml, dry-run, deploy, logs con tail y cómo volver atrás.
Disponible - 5
Conectar con WhatsApp
Cuenta de Meta, número, tokens, recibir mensajes reales y enviar texto, botones y listas.
-
LECCIÓN 12
Cuenta y app de Meta
Crea tu cuenta de desarrollador, la app de negocio, la cuenta de WhatsApp Business y el número de prueba, y entiende qué token usar y cuál guardar.
Disponible -
LECCIÓN 13
Recibir mensajes reales
Conecta el webhook de tu Worker con Meta, verifica la URL, suscríbete al campo de mensajes y mira llegar un mensaje real de tu celular.
Disponible -
LECCIÓN 14
Enviar mensajes
Envía texto, botones y listas con la Graph API usando las funciones del código del curso, respeta los límites de WhatsApp y diagnostica los errores comunes.
Disponible -
LECCIÓN 27
Practica con Telegram sin cuenta de Meta
Conecta el mismo motor de reglas a un bot de Telegram para practicar webhooks, botones y sesiones sin esperar aprobaciones de Meta ni gastar un sol.
Disponible -
LECCIÓN 28
Otros proveedores y alternativas a la API directa
Compara la Cloud API directa de Meta con proveedores como Twilio y 360dialog y con librerías no oficiales, para elegir con criterio y sin riesgos para el negocio.
Disponible - 6
Memoria y datos
Guardar sesiones y pedidos, y darle al dueño un panel con Google Sheets.
-
LECCIÓN 15
Memoria con Cloudflare KV
Guarda sesiones, pedidos e ids de mensajes en Cloudflare KV con vencimiento automático (TTL) y aprende sus límites reales para no perder datos.
Disponible -
LECCIÓN 16
Panel del dueño con Google Sheets
Guarda cada pedido del bot como una fila en Google Sheets mediante una aplicación web de Apps Script protegida con secreto, y arma un panel sencillo para el dueño.
Disponible - 7
Plantillas y automatización
Escribir primero: plantillas aprobadas, recordatorios programados y formularios con Flows.
-
LECCIÓN 17
Plantillas de mensaje
Crea plantillas de WhatsApp, entiende sus categorías y su aprobación, envíalas con variables y botones de respuesta rápida usando whatsapp.js, y recibe lo que el cliente toca.
Disponible -
LECCIÓN 18
Recordatorios y seguimiento automático
Cómo enviar avisos útiles a tiempo con un cron, elegir entre texto libre y plantilla según la ventana de 24 horas, y respetar la baja del cliente.
Disponible -
LECCIÓN 19
Formularios dentro de WhatsApp con Flows
Qué son los WhatsApp Flows, cómo es su JSON, cómo se envían y se leen sus respuestas, cuándo hace falta un endpoint y cuándo bastan botones.
Disponible - 8
Marketing y costos
Promociones sin spam, permisos de los clientes y cuánto cuesta cada mensaje.
-
LECCIÓN 20
Marketing responsable por WhatsApp
Cómo conseguir y registrar el permiso de tus clientes, respetar la baja al instante, enviar promociones útiles y cuidar la calidad de tu número para no ser limitado.
Disponible -
LECCIÓN 21
Costos y métricas de tu bot
Cómo cobra Meta cada mensaje, cuánto cuesta realmente un bot pequeño con su infraestructura y qué métricas registrar para saber si el bot le sirve al negocio.
Disponible - 9
Inteligencia artificial
Cuándo y cómo añadir IA a un bot de reglas sin perder el control.
-
LECCIÓN 22
IA como complemento, no como cerebro
Cuándo y cómo sumar inteligencia artificial a un bot de reglas: clasificar texto libre, validar su salida, controlar costos y no dejarla inventar precios.
Disponible - 10
Producción y negocio
Pruebas, errores, seguridad, atención humana y cómo ofrecer tu bot a un negocio.
-
LECCIÓN 23
Pruebas, registros y errores comunes
Cómo probar un bot con node:test, conversaciones completas y payloads reales, qué registrar en los logs, cómo reintentar bien y qué significan los errores 131xxx de WhatsApp.
Disponible -
LECCIÓN 24
Seguridad y privacidad
Protege secretos y tokens, verifica la firma de Meta, limita el abuso y trata los datos de tus clientes con mínimo necesario, retención y borrado a petición.
Disponible -
LECCIÓN 25
Atención humana y traspaso
Cómo pasar una conversación a una persona sin que el bot interfiera, respetar horarios, avisar al dueño y devolverle la conversación al bot cuando corresponde.
Disponible -
LECCIÓN 26
Vender tu bot como servicio
Cómo convertir lo aprendido en un servicio para negocios: a quién ofrecerlo, qué prometer y qué no, cómo cotizar, hacer la demo, acordar datos y dar mantenimiento.
Disponible - ★
Cierre del curso
Junta todo y entrega un bot real.
-
PROYECTO FINAL
Proyecto final: el bot del minimarket
Arma de punta a punta el bot de Minimarket La Esquina reutilizando el código de referencia: pruebas, atención humana, despliegue, conexión con WhatsApp, checklist de entrega y criterios de evaluación.
Disponible
📝 Lo que aprendí construyendo esto: decisiones y errores reales →