¿Qué es un webhook?

Qué es

Hay dos formas de enterarte de que algo pasó en otro sistema:

• Preguntar a cada rato: “¿Llegó algo? ¿Y ahora?”. Es lento y desperdicia recursos.
• Que te avisen: el otro sistema te llama apenas ocurre. Eso es un webhook.

Técnicamente, un webhook es una dirección web (URL) de tu sistema a la que otro servicio envía datos cuando sucede un evento.

Cómo lo usa WhatsApp

En la API de WhatsApp Business, cuando un cliente te escribe, Meta envía ese mensaje a la URL de webhook que configuró tu plataforma. También avisa sobre el estado de los mensajes que tú envías y sobre cambios importantes en tu cuenta.

Evento	Qué recibe tu sistema
Mensaje nuevo de un cliente	El texto, foto o audio, y el número
Estado de un mensaje enviado	Una actualización sobre ese mensaje
Cambios en la cuenta	Alertas sobre tu límite de mensajería, tu perfil o tu estado de cuenta oficial

Sin webhook, tu chatbot no se enteraría de que alguien le escribió.

Por qué importa para tu negocio

No necesitas configurar webhooks tú mismo si usas un proveedor: tu BSP o plataforma lo hace. Pero conviene entender el concepto por dos razones:

1. Velocidad. Gracias al webhook, el bot puede responder en segundos, aunque sean las 3 de la mañana.
2. Integraciones. Si quieres que un pedido de WhatsApp llegue a otro sistema, alguien tendrá que hablar de webhooks o de una API. Saber qué son te ayuda a hacer las preguntas correctas.

Ejemplo

Un cliente escribe a Sabor Criollo (ejemplo ficticio): “¿Hacen delivery a Barranco?”.

1. WhatsApp recibe el mensaje.
2. Meta lo envía por webhook al sistema del restaurante.
3. El agente de IA lee la pregunta, revisa las zonas de reparto que cargó el dueño y responde.
4. Meta envía otro webhook con el estado de esa respuesta.

Todo ocurre en segundos, sin que nadie del equipo toque el celular.

Errores comunes

• Servidor caído. Si el sistema que recibe los webhooks se cae, los mensajes no se procesan a tiempo. Pregunta a tu proveedor cómo maneja las caídas.
• Webhook sin seguridad. Hay que verificar que los avisos vienen de Meta y no de cualquiera.
• Procesar el mismo mensaje dos veces. Un buen sistema reconoce avisos repetidos y no responde doble.
• Confundir webhook con API. La API es para que tú envíes mensajes; el webhook es para que te avisen de lo que llega.

Si prefieres no lidiar con nada de esto, el asistente de WhatsApp con IA de Ventixs se conecta a la API oficial de Meta y la configuración se hace contigo en menos de 7 días. Mira los planes.