
Capacidades
- Mensajes por WhatsApp
- Secuencias con retardo
- Validación de números
- Sesión con QR
Backend
WhatsApp Bot
CompletadoCuando alguien deja sus datos en la landing de captación, este bot le escribe por WhatsApp en cuestión de segundos con una secuencia de bienvenida: presentación, material y llamada a la acción, espaciados para que la conversación no parezca un volcado automático. Es una API de NestJS sin frontend que automatiza WhatsApp Web con whatsapp-web.js sobre un Chromium headless, y que mantiene la sesión emparejada en disco para sobrevivir a los reinicios del contenedor.
El reto
La secuencia tarda más de medio minuto en enviarse porque cada mensaje espera diez segundos, y quien llama al endpoint es un formulario web que no puede quedarse esperando tanto. La respuesta HTTP y el envío tenían que dejar de ser la misma operación.
Implementación
Responder antes de enviar
El endpoint valida, comprueba el número y devuelve un 202 con lo que ha encolado; la secuencia arranca después, fuera del ciclo de la petición. El formulario recibe su confirmación al momento y nadie se queda mirando un spinner mientras se mandan los mensajes.
Comprobar que el número existe en WhatsApp
Antes de encolar nada se pregunta a WhatsApp si ese teléfono está registrado, con un reintento a un segundo antes de darlo por malo: el primer intento falla a veces mientras la sesión termina de levantar. Un número mal escrito se responde con un 404 en vez de quedarse en el limbo.
Un teléfono, muchas formas de escribirlo
Los datos llegan de un formulario, así que el número puede venir con espacios, guiones o el prefijo repetido. Se normaliza a dígitos, se quita el prefijo duplicado y se recompone el identificador de chat que espera WhatsApp.
Sesión que sobrevive al despliegue
El emparejamiento se hace una vez leyendo un QR desde los logs y queda guardado en disco, así que un reinicio del contenedor no obliga a volver a escanear. El cliente se levanta y se cierra con el ciclo de vida del módulo de Nest.