Webhook de WhatsApp Business: Qué Es y Cómo Funciona
Explicación simple de qué es un webhook de WhatsApp Business, cómo funciona, para qué sirve y cómo configurarlo en tu plataforma.
Un webhook de WhatsApp Business es un mecanismo que le dice a tu sistema “che, pasó algo” cada vez que ocurre un evento en WhatsApp: un mensaje nuevo, un mensaje entregado, uno leído o un cambio de estado. En vez de que tu servidor le pregunte a WhatsApp cada 5 segundos si hay novedades, el webhook hace que WhatsApp te avise.
Si usás una plataforma como WatX, los webhooks ya vienen configurados. No tenés que tocar nada técnico. Pero entender cómo funcionan te ayuda a resolver problemas cuando algo falla y a aprovechar mejor tu integración. Podés probar WatX gratis y olvidarte de la configuración.
La analogía más simple: el cartero
Pensalo así. Sin webhook sería como ir a la oficina de correo cada 5 segundos a preguntar “¿me llegó algo?”. Con webhook, el cartero toca timbre cada vez que tenés un paquete.
En términos técnicos: sin webhook (lo que se llama polling), tu sistema le consulta a WhatsApp periódicamente. Lento, ineficiente, come recursos. Con webhook, WhatsApp le tira una notificación HTTP a tu servidor cada vez que pasa algo. Instantáneo. Eficiente. En tiempo real.
Qué eventos te llegan por webhook
Mensajes
| Evento | Qué significa |
|---|---|
| Mensaje recibido | Alguien te escribió (texto, imagen, audio, documento, lo que sea) |
| Mensaje enviado | Tu mensaje salió al servidor de WhatsApp |
| Mensaje entregado | Llegó al celular del contacto (doble tilde gris) |
| Mensaje leído | Lo abrió (doble tilde azul) |
| Mensaje fallido | No se pudo entregar (número inválido, te bloqueó, etc.) |
Conversaciones
| Evento | Qué significa |
|---|---|
| Conversación iniciada | Se abrió una nueva ventana de chat |
| Conversación expirada | Pasaron 24 horas sin actividad y se cerró |
Cuenta
| Evento | Qué significa |
|---|---|
| Cambio de calidad | Tu semáforo cambió (verde/amarillo/rojo) |
| Template aprobado/rechazado | Una plantilla que mandaste a revisión cambió de estado |
El flujo técnico (simple)
Cuando alguien te manda “Hola” por WhatsApp, pasa esto:
1. Meta recibe el mensaje en sus servidores
2. Meta hace un POST HTTP a tu URL de webhook
3. Tu servidor recibe el POST con los datos del mensaje (JSON)
4. Tu servidor responde con HTTP 200 ("recibido, gracias")
5. Tu plataforma procesa el mensaje (se lo muestra al agente, activa un bot, etc.)Lo importante: tu servidor tiene que responder rápido. Menos de 20 segundos. Si no responde, Meta reintenta varias veces. Si falla seguido, Meta desactiva el webhook y tenés que reactivarlo a mano. Tu URL tiene que ser HTTPS (HTTP no sirve) y el certificado SSL tiene que estar vigente.
Cuando usás WatX, esto ya está resuelto. Nosotros recibimos los webhooks, procesamos todo y te lo mostramos en la bandeja. No configurás servidores ni tocás JSON. Probalo gratis →
Cómo se configuran
Si usás una plataforma (WatX, etc.)
La plataforma se encarga sola. Vos conectás tu número, verificás que los mensajes llegan, y listo. No hay paso técnico.
Si usás la Cloud API directo
Vas a Meta for Developers > Tu app > WhatsApp > Configuración. En la sección Webhooks ponés la URL de tu servidor y un token de verificación (una clave que vos definís). Meta le pega un GET a tu URL con ese token para comprobar que funciona. Tu servidor responde con el challenge token. Después seleccionás qué eventos querés recibir: messages, message_status, y los que necesites.
Problemas comunes (y cómo resolverlos)
“No me llegan mensajes.” Lo primero: ¿tu servidor está accesible desde internet? ¿La URL usa HTTPS? ¿Tarda más de 20 segundos en responder? ¿El certificado SSL está vencido? Cualquiera de esas cuatro cosas corta el webhook.
“Me llegan mensajes duplicados.” Tu servidor responde lento, Meta reintenta, y tu sistema procesa las dos copias. La solución: guardá el ID del mensaje y descartá duplicados.
“Los status de lectura no llegan.” Puede ser que no suscribiste el evento message_status en la configuración. O que el contacto tiene desactivado el doble tilde azul, en cuyo caso WhatsApp directamente no envía ese evento.
Para qué le sirve un webhook a tu negocio
Aunque nunca programes una línea de código, los webhooks son lo que hace posible todo lo interesante de tu plataforma.
Las notificaciones en tiempo real: que tu agente vea el mensaje nuevo al instante. Los chatbots: que el bot reciba el mensaje y conteste solo. Las métricas de entrega: que sepas si el mensaje llegó y si lo leyeron. La reapertura automática: que si un cliente responde a un caso cerrado, se vuelva a abrir. Las integraciones: que un mensaje dispare acciones en tu CRM, ERP o sistema de gestión.
Si querés ir más a fondo con automatizaciones, tenemos una guía de automatización de WhatsApp para PyMEs.
WatX procesa todos los webhooks y te muestra los datos en dashboards claros. Métricas de entrega, lectura, tiempos de respuesta, satisfacción. Todo sin tocar código. Herramientas similares arrancan en USD 50-100/mes. WatX tiene plan gratuito. Crear cuenta gratis → | Ver precios →
Seguridad: no es opcional
Los webhooks manejan datos de tus clientes. La seguridad es crítica.
HTTPS obligatorio. Nunca HTTP. Verificación de firma: Meta firma cada solicitud con un hash para que compruebes que viene de ellos y no de un atacante. Token de verificación: usá uno único y complejo, no “1234”. Logs: registrá todos los webhooks recibidos para auditoría. Si algún día algo falla, los logs son lo primero que vas a mirar.
Lo que te llevás
Un webhook es básicamente un cartero digital que te avisa cuando pasa algo en WhatsApp. Permite recibir mensajes, status de entrega y eventos de cuenta en tiempo real. Si usás una plataforma, ya están configurados y no tenés que hacer nada. Y son la base de todo lo avanzado: chatbots, métricas, integraciones, notificaciones.
¿Querés usar WhatsApp Business API sin complicarte con la parte técnica? Creá tu cuenta gratis en WatX o mirá los planes y precios. Sin código, sin servidor, setup en 10 minutos.
Preguntas Frecuentes
¿Necesito saber programar para usar webhooks de WhatsApp?
No, si usás una plataforma como WatX que maneja la parte técnica. La plataforma recibe los webhooks, los procesa y te muestra la info de forma amigable. Solo necesitarías programar si quisieras hacer una integración personalizada directo con la API de Meta.
¿Qué pasa si mi servidor se cae y no recibe webhooks?
Meta reintenta el envío varias veces con backoff exponencial. Si tu servidor vuelve a estar online dentro de las primeras horas, vas a recibir los mensajes pendientes. Si la caída se extiende, Meta puede desactivar el webhook y tenés que reactivarlo a mano. Plataformas como WatX manejan alta disponibilidad para que esto no pase.
¿Los webhooks de WhatsApp tienen costo?
No. Los webhooks son parte de la infraestructura de WhatsApp Business API y no tienen cargo extra. Lo que se cobra son las conversaciones (mensajes enviados y recibidos), no las notificaciones técnicas sobre esas conversaciones.