WhatsApp se ha convertido en uno de los canales más potentes para la comunicación empresarial. Gracias a la API de WhatsApp Business, ahora es posible automatizar mensajes, recibir eventos en tiempo real y mejorar la experiencia del cliente con respuestas instantáneas. Una de las piezas clave para lograrlo son los webhooks, y en este artículo te explicamos cómo gestionarlos eficazmente usando Node.js.
¿Qué es un Webhook?
Un webhook es una URL a la que WhatsApp enviará solicitudes HTTP (normalmente tipo POST) cada vez que ocurra un evento relevante, como:
• La llegada de un nuevo mensaje
• Un cambio en el estado de entrega o lectura
• Una respuesta automática desde el bot
Esto permite que tu sistema reaccione en tiempo real, sin necesidad de hacer polling ni llamadas constantes a la API.
¿Por qué usar Node.js para Webhooks?
Node.js es una de las tecnologías más eficientes para manejar eventos asíncronos y flujos de datos en tiempo real. Entre sus ventajas están:
• Bajo consumo de recursos para tareas de red
• Fácil integración con librerías HTTP y frameworks como Express.js
• Amplio ecosistema de paquetes para trabajar con WhatsApp y servicios relacionados
Paso a Paso: Configura tu Webhook con Node.js
- Instala tu entorno
npm init -y
npm install express body-parser
2. Código básico del servidor
const express = require(‘express’);
const bodyParser = require(‘body-parser’);
const app = express();
const PORT = 3000;
app.use(bodyParser.json());
// Ruta para verificar el webhook (WhatsApp lo usa al configurarlo)
app.get(‘/webhook’, (req, res) => {
const VERIFY_TOKEN = «mi_token_seguro»;
const mode = req.query[‘hub.mode’];
const token = req.query[‘hub.verify_token’];
const challenge = req.query[‘hub.challenge’];
if (mode && token === VERIFY_TOKEN) {
res.status(200).send(challenge);
} else {
res.sendStatus(403);
}
});
// Ruta para recibir eventos POST de WhatsApp
app.post(‘/webhook’, (req, res) => {
console.log(‘Evento recibido:’, JSON.stringify(req.body, null, 2));
res.sendStatus(200);
});
app.listen(PORT, () => {
console.log(Servidor escuchando en http://localhost:${PORT});
});
¿Qué puedes hacer con los eventos?
Una vez recibes eventos desde WhatsApp, puedes:
• Enviar respuestas automáticas usando la API de WhatsApp
• Registrar mensajes en tu base de datos
• Integrar con tu CRM, chatbot o sistema interno
Por ejemplo, si detectas que un usuario te escribe una palabra clave como “ayuda”, puedes responder automáticamente con información relevante.
⸻
Buenas prácticas
• Guarda logs de los eventos para análisis o auditoría
• No proceses lógicamente dentro del webhook: reenvía el evento a una cola (ej. RabbitMQ, Kafka) si es un sistema de alta carga
• Responde siempre con 200 OK para evitar reintentos de WhatsApp
Integrar webhooks de WhatsApp con Node.js es una excelente forma de potenciar la atención al cliente y crear soluciones de mensajería más inteligentes y reactivas. Con una simple configuración, puedes lograr flujos automatizados y conectarte con tus clientes en tiempo real.
¿Listo para comenzar? ¡Tu sistema de mensajería nunca volverá a ser el mismo!
