Desconexiones y cómo seguir en línea

Resumen

Wazzap se conecta a WhatsApp de la misma forma que WhatsApp Web. Tu teléfono vincula un slot de "dispositivo enlazado" con nosotros, y de ahí el canal vive en nuestra nube. El teléfono puede quedarse en un cajón, los chats siguen fluyendo. Pero hay eventos específicos que rompen ese vínculo:

Por qué se desconectan los números

• Teléfono apagado 14+ días. WhatsApp exige que el teléfono vinculado prenda al menos una vez cada dos semanas. Si no lo hace, la sesión del dispositivo enlazado vence y Wazzap pasa a "Desconectado".
• Slot de dispositivo enlazado reutilizado. WhatsApp permite hasta 4 dispositivos enlazados por número. Si alguien abre WhatsApp Web en un navegador y se llena el tope, el slot de Wazzap es el que se cae.
• El número fue baneado. Meta bloqueó la cuenta por violar políticas o por los triggers anti-spam. Mira conectar tras un ban para la recuperación.
• El usuario cerró sesión manualmente desde WhatsApp → Dispositivos vinculados → Cerrar sesión en todos los dispositivos.
• Cambio de SIM o de teléfono. Si el usuario se pasa a un equipo nuevo y restaura WhatsApp, la sesión vinculada anterior se invalida.
• Actualización de WhatsApp o ventana de mantenimiento. Pasa pocas veces, pero updates grandes a veces tiran las sesiones vinculadas.

Configurar webhook de desconexión

Wazzap expone un webhook en tiempo real que se dispara en el instante en que cualquiera de esos eventos sucede. Se configura por número, así puedes mandar las alertas de distintas sub-cuentas a distintos destinos.

1. Abre el Panel de sub-cuentas en Wazzap.
2. Haz clic en Números de WhatsApp y elige el número específico.
3. Abre Configuración → Disconnection Settings.
4. Activa el evento Disconnected.
5. Pega la URL del Webhook de tu plataforma de automatización (inbound webhook de HighLevel, Zapier, Pabbly, n8n, o tu propio endpoint).
6. Guarda.

Cada número debe configurarse de forma independiente. Si tienes 10 números, arma 10 webhooks.

Payload del webhook

Cada request lleva suficiente identificación para enrutar la alerta:

{
  "phone": "+5215512345678",
  "country": "MX",
  "event": "disconnected",
  "timestamp": "2026-05-14T18:42:11Z"
}

Los campos exactos varían un poco entre versiones, así que diseña la automatización aguas abajo para tolerar payloads mínimos.

Flujo recomendado en HighLevel

El patrón más limpio para usuarios de HighLevel:

1. Trigger: Inbound Webhook se dispara cuando Wazzap manda la desconexión.
2. Identifica la cuenta. Cruza el teléfono recibido contra tus sub-cuentas.
3. Actualiza el estado:
   • Etiqueta al contacto o sub-cuenta con WA_Disconnected.
   • Opcional: flipea un custom field whatsapp_status = offline.
4. Notifica al operador:
   • Mensaje interno de Slack, email o SMS al dueño de la agencia.
   • Crea una tarea de reconexión en la cola del usuario asignado.
   • Si el número corre una campaña, pausa la campaña automáticamente.

Solución de problemas

El webhook no se dispara al cerrar sesión manualmente

El webhook solo se dispara con un evento real de desconexión del lado de WhatsApp. Pruébalo cerrando sesión desde WhatsApp → Dispositivos vinculados → Cerrar sesión en el teléfono, no toggleando el panel de Wazzap.

El número aparece "Desconectado" pero nunca cerré sesión

Abre WhatsApp en el teléfono y revisa Dispositivos vinculados. Si nuestra sesión ya no aparece, alguien reutilizó el slot vía WhatsApp Web. Re-escanea el QR en Wazzap y pídele al equipo que nunca abra WhatsApp Web desde el navegador en ese número.

La reconexión sigue fallando

Probablemente el número está baneado. Manda un mensaje desde la app de WhatsApp directamente. Si ves "No puedes enviar mensajes en WhatsApp", el número está bloqueado. Sigue el protocolo de conectar tras un ban.