Cómo funciona un bot de WhatsApp

1.Qué es (y qué no es) un bot de WhatsApp

Un bot de WhatsApp es un programa que lee los mensajes que le escriben a un número de WhatsApp y responde automáticamente. Para el cliente es una conversación normal; al otro lado no hay una persona tecleando, hay código que decide qué contestar.

Un bot no es magia ni «inteligencia artificial» por definición. La mayoría de los bots útiles en negocios pequeños son bots de reglas: si el cliente escribe tal cosa, responde tal otra. Eso es lo que aprenderás a construir primero, porque es predecible, barato y fácil de depurar. En la lección 22 verás cuándo tiene sentido sumar IA.

A lo largo del curso construirás el bot de un minimarket ficticio («Minimarket La Esquina»): mostrará su catálogo, armará pedidos, preguntará por delivery, enviará recordatorios y promociones. Lo que aprendas sirve para cualquier negocio: una ferretería, un taller, una academia, un restaurante.

2.El camino de un mensaje

Cuando un cliente escribe, el mensaje no llega mágicamente a tu programa. Pasa por estos pasos:

1. El cliente escribe a tu número de negocio.
2. Los servidores de Meta (la empresa dueña de WhatsApp) reciben el mensaje.
3. Meta llama a una dirección web tuya, el webhook, y le entrega el mensaje en formato JSON.
4. Tu código lee el mensaje, decide la respuesta y la envía haciendo una petición HTTPS a la API de Meta.
5. Meta entrega tu respuesta al cliente.

Fíjate en la idea clave: tu bot es un servidor web. Recibe peticiones (los mensajes) y hace peticiones (las respuestas). Si ya viste el curso de Node.js y APIs, esto te resultará familiar: es el mismo trabajo, con WhatsApp como cliente.

3.Tres cosas que se llaman «WhatsApp»

Mucha confusión inicial viene de mezclar estas opciones:

La app de WhatsApp Business ya resuelve mucho para un negocio muy pequeño (y a veces es suficiente). Pasas a la API cuando necesitas automatizar conversaciones, conectarlas con tus datos (pedidos, citas, inventario) o escribirle a muchos clientes con mensajes aprobados.

4.Las piezas de la API oficial

La API oficial se llama WhatsApp Cloud API: Meta la aloja por ti y no tienes que instalar nada. (Existió una versión «On-Premises» que se instalaba en un servidor propio; Meta la retiró, así que si encuentras tutoriales que la usan, están desactualizados.)

Para usarla necesitas conocer estas piezas, que configurarás en la lección 12:

También puedes saltarte parte de esa burocracia contratando un proveedor de soluciones (BSP), como Twilio o 360dialog, que ofrece sus propias herramientas encima de la API oficial y cobra por ello. En el curso usas la API directa de Meta porque es la forma más barata y la que mejor enseña cómo funciona todo; lo que aprendas se traslada a cualquier proveedor.

5.Por qué no usar librerías «no oficiales»

Quizá viste tutoriales que prometen «un bot de WhatsApp gratis en 10 minutos» con librerías como whatsapp-web.js o Baileys. Funcionan imitando a WhatsApp Web: tu programa se hace pasar por un navegador con tu cuenta.

Parece una ganga, pero para un negocio es una mala idea:

• Violan las condiciones de uso de WhatsApp. Pueden bloquear el número sin previo aviso, y con él se van tus conversaciones y tus clientes.
• Dependen de ingeniería inversa: cualquier cambio de WhatsApp las rompe.
• No tienen garantías, ni soporte, ni forma de apelar un bloqueo.
• Si vendes un bot a un cliente y se cae o lo bloquean, el problema es tuyo.

La API oficial cuesta algo (lo verás en la lección 21), pero es la única opción seria para un servicio que otros usarán.

6.La regla de las 24 horas

Es la regla más importante de toda la plataforma y condiciona el diseño de tu bot.

• Cuando el cliente te escribe, se abre una ventana de atención al cliente de 24 horas.
• Dentro de la ventana puedes enviar mensajes libres: texto, imágenes, botones, listas… lo que quieras.
• Fuera de la ventana solo puedes enviar plantillas de mensaje (message templates): textos con formato fijo que Meta aprueba antes y que se envían solo a clientes que aceptaron recibirlos.
• Cada vez que el cliente escribe de nuevo, la ventana se renueva.

Por eso un recordatorio de pedido enviado al día siguiente casi siempre sale como plantilla, y por eso un bot bien diseñado intenta resolver todo mientras la ventana está abierta. Las plantillas se pagan y tienen categorías (marketing, utilidad, autenticación); las verás con calma en las lecciones 17, 18 y 21.

7.Permiso del cliente (opt-in)

Para escribirle a alguien por iniciativa tuya (fuera de una conversación que él empezó) necesitas su consentimiento previo: el opt-in. Por ejemplo, un cliente que marca una casilla «Quiero recibir novedades por WhatsApp» al comprar, o que te escribe «quiero que me avisen cuando haya ofertas».

Sin opt-in, tus mensajes serán reportados como spam, la calidad de tu número bajará y Meta puede limitar o suspender tu cuenta. Es una regla de convivencia y de negocio: un bot que molesta pierde clientes. Volverás a esto en la lección 20.

8.Qué construirás y en qué orden

El curso va de lo seguro a lo real, para que puedas aprender sin gastar un sol ni esperar aprobaciones de nadie:

1. Lecciones 1 a 8: el bot funciona en tu consola. Aprendes diseño y el «cerebro» sin necesitar WhatsApp.
2. Lecciones 9 a 11: lo conviertes en un servidor con webhook y lo publicas en la nube.
3. Lecciones 12 a 14: lo conectas a WhatsApp de verdad.
4. Lecciones 15 a 21: memoria, recordatorios, plantillas, formularios y marketing.
5. Lecciones 22 a 26 y proyecto final: IA opcional, pruebas, seguridad, atención humana y cómo ofrecerlo a un negocio.

9.Errores frecuentes

• Creer que la API es «gratis y sin límites». Tiene costos por mensaje de plantilla y reglas estrictas. Entenderlas desde el inicio evita sorpresas.
• Usar una librería no oficial para ahorrar. Funciona hasta que bloquean el número del negocio.
• Intentar escribir primero a un cliente con texto libre. Fuera de la ventana de 24 horas, la API lo rechaza: hay que usar una plantilla aprobada.
• Enviar promociones sin permiso. El opt-in es una condición para existir en la plataforma, no un detalle.
• Confundir el número de prueba con el de producción. El número de prueba es solo para practicar y tiene límites de destinatarios.

10.Apuntes para llevar

• Un bot de WhatsApp es un servidor web: recibe mensajes por webhook y responde con llamadas a la API.
• Para negocios se usa la WhatsApp Cloud API (oficial, alojada por Meta); las librerías no oficiales arriesgan el bloqueo del número.
• Las piezas: portafolio de Meta, cuenta WABA, número, app, token y webhook.
• Ventana de 24 horas: dentro, mensajes libres; fuera, solo plantillas aprobadas.
• Escribir por iniciativa propia exige opt-in del cliente.
• Precios y reglas cambian: consulta siempre la documentación oficial de Meta.

11.Glosario