Curso online de Desarrollo de chatbot de WhatsApp con API Oficial, Node.js e IA Avanzada (ChatGPT y Dialogflow) bonificado

💻 Software

• Node.js 22 LTS — descarga gratuita en nodejs.org. Instala también npm (viene incluido).
• Visual Studio Code — editor gratuito recomendado. Vale cualquier editor con soporte JS/TS.
• Postman — gratuito para pruebas de API REST. Imprescindible para probar la WhatsApp Cloud API.
• Git — gratuito. Necesario para subir el proyecto a GitHub y desplegar en Render.
• Redis — puedes usar Redis Stack local (gratuito) o una instancia gratuita en Upstash.
• MySQL — MySQL Community Edition gratuita o usar PlanetScale/Railway en su tier gratuito.

?️ Hardware

• PC o Mac de los últimos 6 años, procesador de doble núcleo, 4 GB de RAM (8 GB recomendados si levantas Redis y MySQL locales a la vez).
• Conexión a internet estable — imprescindible para trabajar con APIs en la nube.

🔑 Cuentas necesarias

• Meta for Developers — gratuita (developers.facebook.com).
• Google Cloud — gratuita para Dialogflow ES (console.cloud.google.com).
• OpenAI Platform — necesita tarjeta; créditos de pago por uso (platform.openai.com).
• GitHub — gratuito.
• Render.com — tier gratuito suficiente para el despliegue del curso.

📚 Conocimientos previos

• JavaScript intermedio — funciones, promesas, async/await, módulos ES.
• Nociones básicas de HTTP y REST APIs (qué es un endpoint, cabeceras, JSON).
• Haber creado algún proyecto con Node.js/Express, aunque sea un tutorial básico.
• SQL básico (SELECT, INSERT) para la parte de MySQL.

Construirás un chatbot real sobre WhatsApp conectado a IA, bases de datos y desplegado en la nube. Estos son los proyectos que habrás completado al terminar el curso:

1. Bot de WhatsApp con menú interactivo de botones y listas — implementas un asistente que responde a opciones estructuradas. Caso de uso: menú de atención al cliente para una tienda online con opciones como «Estado de mi pedido», «Hablar con soporte» o «Ver catálogo».
2. Integración de Redis para gestión de sesiones y pasos del menú — el bot recuerda en qué punto del flujo está cada usuario. Caso de uso: proceso de reserva en varios pasos (fecha → hora → confirmación) sin perder el contexto entre mensajes.
3. Bot con base de datos MySQL en tiempo real — el chatbot consulta y escribe en MySQL según la interacción. Caso de uso: bot de seguimiento de pedidos que consulta el estado directamente en la base de datos del negocio.
4. Agente conversacional con Dialogflow ES — defines intents, entities y payloads personalizados conectados al bot. Caso de uso: asistente de FAQs para una clínica que entiende variaciones del lenguaje natural («¿tenéis cita disponible?», «quiero pedir hora»).
5. Chatbot con memoria conversacional usando la API de OpenAI — integras ChatGPT con historial de mensajes para respuestas contextuales. Caso de uso: asistente de soporte técnico que recuerda el problema descrito anteriormente y da respuestas progresivas.
6. Despliegue del chatbot completo en Render — subes la aplicación a producción con GitHub Actions. Caso de uso: bot accesible 24/7 desde un número de WhatsApp real sin servidor propio.

Estos son los errores más frecuentes al desarrollar chatbots con WhatsApp API, Node.js e IA. Identificarlos antes te ahorra horas de depuración:

• No validar el token de verificación del webhook. Meta envía un GET con hub.verify_token al registrar el webhook. Si tu servidor no responde con hub.challenge correctamente, la configuración falla y nunca recibirás mensajes.
• Confundir el número de teléfono de prueba con el de producción. El sandbox de Meta solo permite enviar mensajes a números previamente autorizados. Intentar enviar a cualquier número sin aprobación devuelve error 131030 sin explicación clara.
• No gestionar el estado de conversación entre mensajes. WhatsApp no mantiene sesión: cada mensaje llega como una petición nueva. Sin Redis u otra capa de estado, el bot no sabe en qué paso del menú está el usuario y reinicia el flujo en cada mensaje.
• Llamar a la API de OpenAI sin incluir el historial de mensajes. Enviar solo el último mensaje del usuario hace que el modelo responda sin contexto. El resultado son respuestas incoherentes que parecen «amnesia» del bot.
• No manejar errores en las llamadas a APIs externas con try/catch. Si Dialogflow, OpenAI o MySQL fallan, un error no capturado rompe el proceso de Node.js completo, dejando el bot sin respuesta para todos los usuarios.
• Ignorar los tipos de mensaje de WhatsApp entrantes. Un usuario puede enviar audio, imagen o ubicación. Si el código solo maneja type: 'text', los demás mensajes causan excepciones o silencios que confunden al usuario.
• Subir las claves API al repositorio de GitHub. Hardcodear OPENAI_API_KEY o el token de Meta en el código y hacer push es el error de seguridad más común. Usa siempre variables de entorno con .env y .gitignore.
• No configurar el timeout en peticiones a IA. Las llamadas a OpenAI o Dialogflow pueden tardar varios segundos. Sin timeout, el webhook de Meta expira (10 s) y reintenta el mensaje, generando respuestas duplicadas.
• Confiar en que Dialogflow entiende todo sin entrenamiento suficiente. Un intent con dos frases de entrenamiento falla con variaciones reales del lenguaje. Necesitas al menos 10-15 expresiones por intent para una precisión aceptable.

Recursos gratuitos para que llegues preparado al curso y sigas aprendiendo después.

⚡ Atajos y comandos esenciales

• node --version y npm --version — verifica que tienes Node 22 LTS instalado antes de empezar.
• npm init -y — crea el package.json del proyecto en segundos.
• npm install express dotenv axios — paquetes base para el 80% del proyecto.
• npx nodemon index.js — recarga el servidor automáticamente al guardar cambios, imprescindible en desarrollo.
• redis-cli ping — comprueba que Redis responde antes de ejecutar el bot.

?️ Herramientas gratuitas

• Postman (postman.com) — prueba los endpoints de WhatsApp Cloud API y depura respuestas JSON visualmente.
• Ngrok (ngrok.com) — expone tu servidor local a internet para recibir webhooks de Meta durante el desarrollo sin necesidad de desplegar.
• Upstash (upstash.com) — Redis serverless con tier gratuito. Perfecto para gestionar estados de conversación sin instalar Redis localmente.
• Railway o PlanetScale — MySQL en la nube con tier gratuito para las prácticas de base de datos del curso.
• Render.com — despliegue gratuito de aplicaciones Node.js. El curso lo usa directamente para producción.

📖 Documentación oficial

• WhatsApp Cloud API — developers.facebook.com/docs/whatsapp/cloud-api. Referencia completa de endpoints, tipos de mensaje y webhooks.
• Dialogflow ES — cloud.google.com/dialogflow/es/docs. Guías de intents, entities y fulfillment.
• OpenAI API Reference — platform.openai.com/docs/api-reference. Parámetros de la API de chat completions y guía de contexto conversacional.
• Node.js 22 Docs — nodejs.org/docs/latest/api. Referencia de módulos nativos usados en el curso.

👥 Comunidades activas

• r/node en Reddit — dudas de Node.js resueltas por la comunidad.
• r/ChatGPT y r/LocalLLaMA — para profundizar en integración de modelos de lenguaje.
• Stack Overflow — etiquetas whatsapp-cloud-api, dialogflow-es y node.js cubren la mayoría de errores que encontrarás.
• Discord oficial de Botpress y Voiceflow — aunque el curso usa Dialogflow, estas comunidades comparten patrones de diseño de flujos conversacionales extrapolables.