Webhooks en tiempo real para llamadas de WhatsApp

Resumen

Los webhooks de llamadas de WhatsApp dejan que Wazzap mande una petición HTTP en tiempo real a la URL que elijas cada vez que ocurre uno de cuatro eventos de llamada en un número conectado. El caso de uso más valioso son las llamadas perdidas: convierte cada una en un contacto y un workflow de seguimiento para que ningún prospecto se pierda.

Eventos

1. Llamada entrante: dispara cuando se ofrece la llamada a tu número.
2. Llamada aceptada: dispara cuando contestan.
3. Llamada rechazada: dispara cuando declinan.
4. Llamada perdida: dispara cuando nadie contesta.

Cada evento manda su propia petición HTTP, así puedes mandar cada uno a una URL distinta.

Configuración

Los webhooks se configuran a nivel número dentro del panel de sub-cuenta:

1. Abre Números de WhatsApp.
2. Selecciona el número específico.
3. Abre Configuración.
4. Ve a Calls Settings.
5. Pega la URL del webhook para cada evento que quieras trackear.
6. Guarda.
7. Prueba con una llamada real. El endpoint solo se activa una vez que llega un evento real.

Cada número conectado se configura por separado.

Payload

Cada evento manda el mismo payload JSON compacto:

{
  "event": "call.missed",
  "phone": "+5215512345678",
  "country": "MX",
  "ts": "2026-05-14T14:32:11Z"
}

El string event es uno de call.incoming, call.accept, call.reject, call.missed. phone es el número del llamante en formato E.164, country es el código de país ISO 3166-1 alpha-2.

HighLevel paso a paso

En HighLevel, conecta el webhook a un Inbound Webhook Trigger. El trigger dispara cuando Wazzap manda el evento de llamada. Desde ahí puedes:

1. Buscar contacto por teléfono en el CRM.
2. Si existe: actualizar el contacto con el timestamp de la última llamada.
3. Si no: crear un nuevo contacto con teléfono y país.
4. Acción opcional: mandar un SMS o disparar un WhatsApp con un disparador de etiqueta.

El Inbound Webhook Trigger es una acción premium en HighLevel y puede tener costo adicional. Revisa la documentación oficial de HighLevel para precios vigentes.

Ejemplo: llamada perdida

1. Un prospecto llama a tu número de WhatsApp, nadie contesta.
2. Wazzap manda al webhook de llamadas perdidas:

{
  "event": "call.missed",
  "phone": "+5215587654321",
  "country": "MX",
  "ts": "2026-05-14T14:32:11Z"
}

3. HighLevel no encuentra contacto con ese número, lo crea y aplica la etiqueta callback-pendiente.
4. Un workflow escuchando esa etiqueta dispara un WhatsApp por Wazzap: "Hey, perdón que no contestamos, aquí tienes un link para agendar".

Notas importantes

• Los webhooks son por número. Un número nuevo necesita configuración nueva.
• El endpoint solo se activa después de una prueba con llamada real. No esperes tráfico en la URL hasta que dispares cada evento que configuraste.
• El payload solo trae phone, country, event y ts. No diseñes workflows alrededor de campos que no existen.
• Siempre manda los webhooks a endpoints HTTPS con un token secreto en la URL o en un header.
• Plataformas comunes que consumen estos webhooks: Zapier, Pabbly, HighLevel y n8n vía la integración nativa.

Solución de problemas

La URL del webhook nunca recibe una petición

Verifica que la URL sea públicamente accesible y regrese un estado 2xx. Wazzap no sigue redirecciones y no reintenta en errores 5xx. Prueba primero con una herramienta como webhook.site.

Las llamadas disparan pero solo algunos eventos llegan

Cada evento necesita su propia URL en Calls Settings. Si solo llenaste missed, ese es el único evento que va a disparar.