Un cliente envía un mensaje a tu número de WhatsApp Business API a las 2:00 PM. El servidor de Meta recibe el mensaje. La pregunta es: ¿cómo sabe tu sistema de negocio que llegó un mensaje nuevo? Hay dos formas: tu servidor consulta a Meta de forma continua (polling), o Meta notifica a tu servidor cuando llega un mensaje nuevo (webhook).
El polling es desperdicioso y lento. Tu servidor gasta recursos consultando continuamente ‘¿hay algún mensaje nuevo?’ cada pocos segundos, y la latencia de respuesta al cliente puede alcanzar decenas de segundos.
Los webhooks son eficientes y funcionan en tiempo real. Meta envía automáticamente los datos del mensaje a tu servidor en milisegundos después de que llega un mensaje. Este es el mecanismo estándar de WhatsApp Business API y la base de los chatbots, las respuestas automáticas y la integración con CRM en tiempo real.
Esta guía explica qué son los webhooks, qué eventos de la API de WhatsApp se pueden activar, cómo configurar un webhook, los fallos habituales que conviene anticipar y las buenas prácticas para sistemas en producción.
Ventajas clave
- Respuesta en tiempo real: mensajes entrantes procesados en milisegundos, lo que permite chatbots ágiles y respuestas automáticas.
- Eficiencia de recursos: no hace falta consultar de forma continua; el servidor solo trabaja cuando ocurre un evento real.
- Base para la automatización: los chatbots con IA, la integración con CRM y los flujos automatizados necesitan webhooks para funcionar.
- Seguimiento del estado de los mensajes: los webhooks también notifican cuando tus mensajes se entregan, se leen o fallan, lo que permite obtener analíticas precisas.
¿Qué es un webhook?

Un webhook es un mecanismo en el que un sistema (en este caso, Meta) envía automáticamente datos a otro sistema (tu servidor de negocio) cuando ocurre un evento concreto. A diferencia de una API habitual, en la que tienes que solicitar los datos, un webhook es un ‘push’: Meta envía de forma activa.
Técnicamente, un webhook funciona mediante una solicitud HTTP POST. Meta envía una solicitud POST a una URL que registras (normalmente llamada el endpoint del webhook), con un payload que contiene los datos del evento. Tu servidor procesa el payload y responde con HTTP 200 OK dentro de un límite de tiempo concreto (normalmente 20 segundos).
En el caso de WhatsApp Business API, el webhook es la forma principal de recibir mensajes entrantes y actualizaciones del estado de los mensajes. Sin un webhook, la integración con la API de WhatsApp estaría muy limitada.
Eventos de la API de WhatsApp que se pueden activar
Meta envía varios tipos de eventos mediante webhook. Los más importantes para las operaciones del negocio:
Mensajes entrantes. Mensajes nuevos de clientes. El payload contiene el número del remitente, el contenido del mensaje (texto, imagen, documento u otro contenido multimedia), la marca de tiempo y el ID del mensaje.
Actualizaciones del estado de los mensajes. Actualizaciones de estado de los mensajes que envía la empresa: enviado, entregado, leído, fallido. Útiles para seguir la tasa de entrega y la tasa de lectura.
Actualizaciones del estado de las plantillas. Notificaciones cuando Meta aprueba, rechaza o marca los mensajes de plantilla por problemas de calidad.
Alertas de cuenta. Cambios de estado importantes como una caída en la calificación de calidad, un cambio de nivel de mensajería o una infracción de las políticas. Esto es muy importante para vigilar la salud de la cuenta.
Reacciones a los mensajes. Cuando los clientes reaccionan con un emoji a un mensaje de tu empresa.
Las empresas suelen registrar webhooks para todos estos tipos de evento, aunque no todos se procesen. Registrar todos los eventos deja el sistema preparado para cuando surjan nuevas necesidades.
Para obtener más contexto sobre WhatsApp Business API y sus componentes, consulta WhatsApp Business API: guía completa.
Cómo configurar un webhook
La configuración de un webhook implica tres componentes: endpoint URL, token de verificación y HTTPS.
Endpoint URL. La URL de tu servidor de negocio que recibirá las solicitudes POST de Meta. Ejemplo: `https://api.your-business.com/webhook/whatsapp`. La URL debe ser pública y accesible para Meta.
Token de verificación. Una cadena secreta que creas tú mismo para verificar que las solicitudes entrantes provienen realmente de Meta y no de un atacante. Meta envía este token en cada solicitud y tu servidor debe coincidir con él.
HTTPS. Meta solo envía webhooks a URLs HTTPS. No se acepta HTTP simple. El certificado SSL debe ser válido y no autofirmado.
Una vez listos estos tres componentes, la configuración del webhook se realiza en el panel de WhatsApp Business Platform o a través de un BSP. La configuración inicial exige un proceso de desafío de verificación de Meta: Meta envía el token de verificación y tu servidor debe responder con el eco correspondiente.
Fallos habituales que conviene anticipar

Servidor caído o respuesta lenta
Si tu servidor no responde en 20 segundos, Meta lo considera un fallo y reintenta. Los reintentos continúan con intervalos cada vez mayores. Si el fallo persiste, Meta puede desactivar temporalmente el webhook.
Eventos perdidos por tiempo de inactividad
Cuando el servidor está caído durante varias horas, los eventos que llegan en ese periodo pueden perderse si fallan los reintentos de Meta. Para sistemas en producción, usa un sistema de colas (como RabbitMQ o AWS SQS) para almacenar los eventos en búfer antes de procesarlos.
Fallo en la verificación de la firma
Meta firma cada solicitud con una firma que se puede verificar. Si se omite esta verificación, el sistema queda expuesto a webhooks falsos. Verifica siempre la firma antes de procesar el payload.
Límite de peticiones en el servidor de negocio
Si el volumen de webhooks es alto (como grandes difusiones con muchas actualizaciones de estado de entrega), el servidor de negocio debe gestionar cientos de solicitudes por segundo. Los servidores mal dimensionados se convierten en cuellos de botella.
Para entender el papel del BSP en la gestión de webhooks y en la provisión de un endpoint gestionado, consulta ¿Qué es un WhatsApp BSP?.
Buenas prácticas para sistemas en producción
Responde rápido, procesa de forma asíncrona
Tu endpoint de webhook debería limitarse a aceptar el payload, ponerlo en cola y responder de inmediato con 200 OK. El procesamiento real (llamar a la IA, actualizar el CRM, etc.) lo realiza de forma asíncrona un worker independiente. Esto mantiene el tiempo de respuesta del webhook por debajo de 1 segundo.
Idempotencia
Meta puede enviar el mismo evento dos veces por su lógica de reintentos. Tu servidor debe ser capaz de procesar eventos duplicados sin efectos secundarios. Forma habitual: registrar los IDs de mensaje ya procesados.
Monitorización y alertas
Registra el tiempo de respuesta del webhook, la tasa de error y el volumen de eventos. Si hay una anomalía (como una caída o un pico repentino del volumen de eventos), avisa al equipo de operaciones.
Gestión de reintentos
Para el procesamiento asíncrono que falla (como una caída del servicio de IA), implementa reintentos con backoff exponencial y una cola de mensajes fallidos para los eventos que fallan repetidamente.
Seguridad más allá de la firma
La verificación de la firma es el mínimo. Para los datos sensibles, añade autenticación en la capa de red (como la lista blanca de direcciones IP de Meta) y cifra el contenido del payload en reposo.
Dónde encaja el conjunto de herramientas
Construir desde cero una infraestructura de webhooks de calidad de producción exige un equipo de ingeniería con experiencia: sistema de colas, monitorización, lógica de reintentos y seguridad. Para la mayoría de las empresas, esto es una carga que no necesitan.
Plataformas como Cekat ofrecen una capa de webhooks lista para producción: cola de eventos, monitorización, reintentos y seguridad. Las empresas solo necesitan interactuar con una API de alto nivel o un panel, y toda la complejidad de los webhooks queda abstraída detrás.
Para conocer los detalles de las capacidades de WhatsApp Business API, que incluyen infraestructura de webhooks gestionada, consulta la página de WhatsApp Business API.
Por dónde empezar
Si estás construyendo una integración con la API de WhatsApp desde cero, empieza configurando el webhook en un entorno de pruebas antes de pasar a producción. Envía algunos mensajes de prueba y verifica que los eventos llegan correctamente, que las firmas se validan y que el tiempo de respuesta se mantiene por debajo de 1 segundo.
Para sistemas en producción, no te saltes el sistema de colas. Aunque a bajo volumen parece innecesario, se vuelve obligatorio cuando el volumen crece y te evita perder eventos de forma costosa.
Si usas un BSP como Cekat, la mayor parte de la complejidad de los webhooks ya está resuelta. Tu foco puede estar en la lógica de negocio, no en la infraestructura.
Activa la automatización en tiempo real de WhatsApp
Cada segundo sin un webhook en funcionamiento es un segundo en el que tu chatbot no puede responder, la integración con CRM se retrasa y el equipo de atención al cliente pierde el contexto de los mensajes entrantes. Para las empresas que ya han escalado a cientos o miles de chats al día, el webhook no es opcional; es la base.
Si quieres usar un webhook para impulsar chatbots con IA y automatización en tiempo real sin construir la infraestructura tú mismo, el chatbot de WhatsApp con IA de Cekat ofrece chatbots ya integrados con los webhooks de Meta y listos para usar.
Prueba gratis para ver un chatbot funcionando en tiempo real en tu WhatsApp or habla con nuestro equipo para una consulta de configuración de webhook y automatización de WhatsApp que se ajuste a tus necesidades
















