Un webhook de WhatsApp Business API es una notificación HTTP que Meta envía automáticamente a un endpoint de tu sistema cada vez que ocurre un evento relevante en tu número de WhatsApp: llega un mensaje nuevo, cambia el estado de uno enviado (entregado, leído, fallido) o se actualiza la calidad del número. En vez de que tu sistema tenga que preguntarle constantemente a la API "¿hay algo nuevo?", es la WhatsApp Business Platform la que avisa en el momento en que algo sucede.
Por qué existen los webhooks en la API de WhatsApp
La WhatsApp Business API no funciona como la app de WhatsApp Business que cualquier persona descarga en su celular: es una API sobre la que se construyen sistemas, no una interfaz para humanos. Para que esos sistemas puedan reaccionar a una conversación en tiempo real —asignarla a un agente, dispararle a un chatbot, actualizar un ticket— necesitan enterarse del evento al instante, no revisarlo cada cierto tiempo. Los webhooks resuelven exactamente eso: Meta publica el evento una sola vez, con baja latencia, y tu servidor decide qué hacer con él.
Esto es lo que hace posible que, por ejemplo, un mensaje entrante dispare en segundos un flujo de chatbots con IA, una regla de asignación de conversaciones o una actualización automática en tu CRM, sin que nadie tenga que refrescar una pantalla.
Qué tipos de eventos llegan por webhook
Aunque el detalle exacto puede variar según la versión de la API, los eventos que casi toda integración necesita manejar son:
- Mensajes entrantes: texto, imagen, audio, documento, ubicación, respuesta a un botón o lista interactiva, o el envío de un WhatsApp Flow.
- Estados de mensaje saliente: enviado, entregado, leído o fallido — clave para saber si una plantilla o un recordatorio realmente llegó al cliente.
- Cambios de calidad o estado del número: avisos sobre la calidad del número de WhatsApp Business o restricciones de mensajería.
- Eventos de plantillas: aprobación, rechazo o pausa de una plantilla de mensaje por parte de Meta.
- Eventos de cuenta: cambios en la verificación del negocio o en la configuración de la cuenta de WhatsApp Business.
Cada evento llega como un JSON con la información relevante; tu endpoint debe identificar el tipo de evento y decidir qué proceso de negocio disparar.
Cómo funciona en la práctica (a alto nivel)
- Configuras una URL propia (HTTPS, con un token de verificación) en el panel del número de WhatsApp Business o del proveedor que te da acceso a la API.
- Cuando ocurre un evento, Meta hace una petición POST a esa URL con el payload del evento.
- Tu servidor debe responder rápido (en pocos segundos) confirmando la recepción; si no responde a tiempo, Meta reintenta el envío.
- Tu sistema procesa el evento de forma asíncrona: lo guarda, lo enruta, actualiza un registro o dispara una automatización.
El punto que casi toda guía técnica repite: el endpoint debe confirmar la recepción casi de inmediato y dejar el procesamiento pesado (lógica de negocio, llamadas a otros sistemas) para después, en segundo plano. Un endpoint lento no solo retrasa tu propia automatización: puede hacer que el mismo evento se reintente varias veces y termine procesado por duplicado si no deduplicas.
Construir tu propio listener vs. usar una plataforma que ya lo resuelve
| Listener propio sobre la API | Plataforma con webhooks ya resueltos | |
|---|---|---|
| Quién mantiene el endpoint | Tu equipo de desarrollo | El proveedor |
| Reintentos y deduplicación de eventos | Hay que implementarlos a mano | Ya están resueltos |
| Escalar ante picos de mensajes | Requiere infraestructura propia | Absorbido por la plataforma |
| Disponibilidad 24/7 del endpoint | Responsabilidad interna | Parte del servicio |
| Conectar el evento a atención multiagente, CRM y chatbot | Hay que construirlo | Incluido de fábrica |
| Riesgo ante cambios de la API de Meta | Lo asume tu equipo | Lo absorbe el proveedor |
Ninguna de las dos opciones es "la correcta" en abstracto: depende de qué tan personalizado necesitas que sea el procesamiento de cada evento y de si tu empresa ya tiene (o quiere tener) un equipo dedicado a mantenerlo.
Cuándo conviene construir tu propio webhook y cuándo no
Construir un listener propio tiene sentido cuando el evento de WhatsApp necesita disparar una lógica muy específica del negocio que ningún proveedor va a resolver genéricamente: por ejemplo, actualizar un sistema interno de inventario con reglas particulares, o alimentar un modelo de datos propietario. En ese caso, trátalo como un componente de producción más: con monitoreo, alertas si el endpoint falla y un responsable claro.
No conviene construirlo desde cero cuando lo que en realidad se necesita es lo de siempre: que un mensaje entrante llegue a un agente disponible, que un chatbot responda preguntas frecuentes, que el estado de un recordatorio se refleje en el historial del cliente. Eso ya lo resuelve una plataforma omnicanal como LiveConnect sin que el webhook sea algo que tu equipo tenga que operar.
Qué se puede automatizar con los webhooks (y cómo lo hace LiveConnect)
En LiveConnect, los webhooks de la WhatsApp Business API ya están conectados a la operación: un mensaje entrante llega a la bandeja compartida, se enruta por reglas de asignación de conversaciones, puede disparar un chatbot con IA antes de pasar a un humano, y los estados de entrega de plantillas y recordatorios quedan reflejos en el historial del contacto. Nada de eso exige que tu empresa programe o mantenga un endpoint propio.
Para quienes sí necesitan que ciertos eventos lleguen también a un sistema externo (su propio CRM, un ERP, un data warehouse), lo recomendable no es espejar cada evento sino sincronizar solo los que disparan un proceso de negocio real — el mismo criterio que aplica al integrar WhatsApp Business API con tu CRM o con un ERP.
Errores comunes al trabajar con webhooks de WhatsApp
- No responder rápido al webhook: si el endpoint tarda demasiado, Meta reintenta el mismo evento, lo que puede duplicar procesos si no hay deduplicación.
- Procesar todo de forma síncrona: mezclar la confirmación de recepción con lógica de negocio pesada hace que el endpoint se vuelva el cuello de botella de toda la integración.
- No validar el origen del evento: un endpoint público sin verificación de firma o token queda expuesto a payloads falsos.
- Subestimar el mantenimiento: un webhook que funciona hoy puede dejar de hacerlo si cambia la versión de la API o el formato del payload, y sin monitoreo nadie se entera hasta que un cliente reclama.
- Construir el listener antes de tener claro el proceso de negocio: automatizar un flujo de asignación o escalamiento que todavía no está definido a mano casi siempre obliga a rehacer el desarrollo.
Cómo empezar
Si tu equipo técnico va a construir el listener, define primero qué eventos necesita tu negocio (no todos), quién lo mantiene y cómo se monitorea. Si prefieres que la atención en tiempo real, el enrutamiento y la automatización ya vengan resueltos sin tener que operar un webhook propio, conoce los planes y precios de LiveConnect.
¿Tienes dudas sobre qué eventos necesitas realmente para tu caso? Escríbenos por WhatsApp y lo revisamos juntos.