← Volver a proyectos
WhatsApp Bot

Capacidades

  • Mensajes por WhatsApp
  • Secuencias con retardo
  • Validación de números
  • Sesión con QR

Backend

NestJS
Node.js
TypeScript
WhatsApp
Docker

WhatsApp Bot

Completado

Cuando 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.