Diagnóstico: Sesión de WhatsApp por código QR desconectada repentinamente

Categoría: Solución de problemas
Disponibilidad: Incluido en todos los planes (Estándar, Premium y Evolución)
Tiempo estimado de resolución: 3 a 5 minutos
Rol necesario: Administrador

Cuando conectas tu línea de WhatsApp mediante código QR (identificada en la plataforma con el proveedor Waha), Waclis Inbox funciona como un dispositivo vinculado a tu teléfono móvil principal. Si la sesión se interrumpe por cambios en el celular, cierres accidentales o caídas de red, los mensajes dejarán de fluir temporalmente. En esta guía de diagnóstico aprenderás a identificar la causa exacta de la desconexión, restablecer tu sesión en segundos desde la pestaña Configuración de sesión sin perder tu historial y recuperar los mensajes que hayan entrado durante el corte.

Cuadro de diagnóstico rápido (30 segundos)

Qué observas en pantalla (Síntoma)	Causa raíz más probable	Solución inmediata / Sección de esta guía
El estado de la sesión muestra `Detenido` o `Fallido` en `Configuración de sesión`	La sesión vinculada se cerró desde el celular o expiró el token de sincronización tras una caída de red.	Ir al Paso 2: pulsar `Recrear sesión` y luego `Generar código QR`.
El estado indica `Escanear código QR` pero la cámara del teléfono no logra leer el código en pantalla	Brillo bajo, reflejos en el monitor o cámara del celular dañada o fuera de foco.	Ir al Paso 3 (Alternativa): usar `Generar código de emparejamiento` de 8 caracteres.
El estado muestra `Passkey requerida` o solicita autorización adicional	La línea móvil tiene activada una clave de acceso o bloqueo de seguridad adicional al vincular dispositivos.	Confirmar la passkey en el teléfono móvil y dentro de la utilidad de `Configuración de sesión`.
El teléfono dice "No se puede vincular el dispositivo" al intentar escanear el QR	Ya alcanzaste el límite máximo de 4 dispositivos vinculados permitidos por WhatsApp en tu celular.	Ir al Paso 1: desvincular un dispositivo antiguo en la app móvil de WhatsApp.
La sesión ya volvió a `Operativo` / `Conectado`, pero faltan los chats recibidos durante el corte	Los mensajes recibidos mientras el canal estuvo caído quedaron alojados solo en el teléfono móvil.	Ir al Paso 4: ejecutar `Sincronización global de mensajes` (`Últimas 24 horas` o `Últimos 7 días`).

¿Por qué ocurre este problema y cómo impacta en tu operación?

A diferencia de WhatsApp Cloud API (Oficial de Meta) —que opera 100 % en los servidores de Meta sin depender de un aparato físico—, la conexión de WhatsApp mediante código QR utiliza el conector técnico Waha para mantener un puente en vivo con la aplicación WhatsApp o WhatsApp Business instalada en tu teléfono móvil.

Este esquema es sumamente práctico para pequeños comercios, equipos de venta consultiva o sucursales que necesitan compartir un número existente entre varios agentes y conservar el uso del celular en simultáneo. Sin embargo, al depender de la arquitectura de Dispositivos vinculados de WhatsApp, la sesión puede desconectarse repentinamente en cinco situaciones concretas:

Cierre manual desde el teléfono móvil: Un usuario con acceso físico al celular entró a Dispositivos vinculados y cerró la sesión del navegador/servidor creyendo que era una computadora desconocida.
Teléfono principal desconectado de internet durante un período prolongado: Como la conexión por código QR depende de la sesión del teléfono principal, si el dispositivo pasa varios días continuos apagado o sin conexión a internet, WhatsApp caduca automáticamente las sesiones vinculadas.
Superación del límite de 4 dispositivos vinculados: Si alguien vincula un quinto dispositivo en el celular, WhatsApp rechaza nuevas conexiones o desplaza sesiones anteriores.
Actualización mayor de WhatsApp o cambio abrupto de chip/dispositivo: Cambiar la tarjeta SIM de aparato o reinstalar la aplicación móvil invalida las llaves criptográficas de las sesiones previas.
Fluctuación o microcortes en la conexión de red: Si la conexión experimenta microcortes reiterados, el estado interno de Waha puede pasar a Fallido por desincronización de credenciales.

Importante: Jamás elimines la bandeja de entrada para intentar reconectarla. Si borras la bandeja en Ajustes → Entradas, perderás la asociación directa con las conversaciones abiertas de tus clientes. Toda reconexión debe realizarse sobre la misma bandeja desde su pestaña Configuración de sesión.

Antes de comenzar (Requisitos previos verificables)

Antes de ejecutar los pasos de reparación en Waclis Inbox, asegúrate de contar con:

Rol de Administrador: Solo los usuarios con perfil de Administrador en Waclis Inbox tienen acceso al menú Ajustes → Entradas y a la pestaña Configuración de sesión.
El teléfono físico con la línea de WhatsApp activa: Debe tener al menos 20 % de batería y conexión estable a internet (Wi-Fi o datos móviles).
Verificación de recepción local: Envía o recibe un mensaje de prueba desde el propio celular para confirmar que la línea telefónica no esté suspendida por la operadora móvil ni restringida por WhatsApp.

Árbol de diagnóstico y solución paso a paso en Waclis Inbox

Sigue estos cuatro pasos en orden para restablecer la conexión y recuperar cualquier conversación ocurrida durante la interrupción.

Paso 1: Revisar los dispositivos vinculados en tu teléfono móvil

Toma el teléfono celular donde funciona tu número de WhatsApp y abre la aplicación WhatsApp o WhatsApp Business.
Ingresa al menú de vinculación según tu sistema operativo:

En Android: Toca el icono de tres puntos verticales (⋮) arriba a la derecha y selecciona Dispositivos vinculados.
En iPhone (iOS): Toca Configuración en la barra inferior derecha y selecciona Dispositivos vinculados.

Revisa la lista de sesiones activas:

Si ves 4 dispositivos ocupando todos los cupos y no reconoces alguno (por ejemplo, una sesión vieja de WhatsApp Web en una notebook que ya no usas), tócalo y pulsa Cerrar sesión para liberar al menos un lugar.
Si ves una sesión correspondiente a tu bandeja que dice "Sesión cerrada" o "Toca para volver a iniciar sesión", elimínala para limpiar el registro antes de generar una vinculación limpia desde Waclis Inbox.

Paso 2: Reiniciar el motor de sesión en `Configuración de sesión`

En Waclis Inbox, dirígete a la barra lateral izquierda y haz clic en Ajustes (icono de engranaje) → Entradas.
En el listado de bandejas de entrada, localiza tu canal de WhatsApp por código QR (lo identificarás fácilmente porque muestra la insignia WAHA junto al nombre) y haz clic en el icono de engranaje (Ajustes) de esa fila.
En la barra de pestañas superior de la bandeja, haz clic en Configuración de sesión.
Observa el primer bloque llamado Gestión de sesiones. Allí verás el indicador de estado en tiempo real (que probablemente mostrará Detenido, Fallido o Escanear código QR).
Haz clic primero en el botón Actualizar para refrescar el estado real del servidor.
Si el estado continúa en Detenido o Fallido, haz clic en el botón Recrear sesión.

Qué ocurre al confirmar: El sistema destruye el contenedor de sesión trabado, limpia las llaves temporales corruptas y levanta una instancia limpia lista para vincularse, sin borrar ni un solo contacto ni conversación de tu cuenta.

Paso 3: Vincular mediante código QR o código de emparejamiento de 8 caracteres

Una vez que la sesión está lista para emparejarse dentro de Gestión de sesiones, puedes elegir entre dos métodos oficiales:

Opción A: Escaneo tradicional con cámara (`Generar código QR`)

Dentro de Gestión de sesiones, haz clic en el botón Generar código QR.
En pantalla aparecerá el cuadro con el código QR dinámico (tiene una validez de 60 segundos antes de rotar).
En tu teléfono móvil (WhatsApp → Dispositivos vinculados), pulsa el botón verde Vincular un dispositivo, desbloquea el celular con tu huella o rostro y apunta la cámara al código QR de Waclis Inbox.
Confirmación visual: En menos de 5 segundos el cuadro del QR desaparecerá y el indicador de estado cambiará a color verde con la leyenda Operativo o Conectado.

Opción B: Vinculación sin cámara (`Generar código de emparejamiento`)

Si la cámara de tu teléfono está rota, no enfoca el monitor o el encargado que tiene el celular está en otra oficina y no puedes enviarle una foto del QR antes de que venza:

En la sección Gestión de sesiones de Waclis Inbox, haz clic en el botón Generar código de emparejamiento.
La pantalla mostrará un código alfanumérico de 8 caracteres (por ejemplo, K7M9-P2X4).
En el teléfono móvil, entra a Dispositivos vinculados → Vincular un dispositivo y, en la parte inferior de la pantalla de escaneo, toca el enlace Vincular con el número de teléfono.
Escribe los 8 caracteres exactos en el celular y confirma.
Confirmación visual: Al instante la sesión pasará a estado Operativo / Conectado en Waclis Inbox.

Paso 4: Recuperar los mensajes perdidos durante el corte (`Sincronización global de mensajes`)

Cuando reconectas una sesión, los mensajes nuevos comienzan a entrar de inmediato, pero ¿qué pasa con los clientes que te escribieron mientras el canal estuvo desconectado? Esos mensajes están en tu teléfono, y puedes importarlos en un clic:

Permanece en Ajustes → Entradas → [Tu bandeja WAHA] → Configuración de sesión.
Desplázate hacia abajo hasta la segunda sección llamada Sincronización global de mensajes.
En el selector de rango temporal, elige una de las dos opciones disponibles según cuánto tiempo haya durado la desconexión:

Últimas 24 horas: Ideal si la sesión se desconectó hoy mismo o durante la noche anterior.
Últimos 7 días: Ideal si el problema ocurrió durante un fin de semana largo o varios días sin supervisión.

Haz clic en el botón Sincronizar mensajes.
Confirmación visual: Verás un aviso de sincronización en progreso. En pocos minutos, Waclis Inbox recorrerá el historial del teléfono, creará o reabrirá las conversaciones de los clientes que escribieron durante el corte y colocará sus mensajes en orden cronológico dentro de tu bandeja.

Qué significa cada control en la pestaña `Configuración de sesión`

Sección / Control en UI	Función exacta en Waclis Inbox	Cuándo utilizarlo o valor recomendado
Estado: `Operativo` / `Conectado`	Confirma que el puente con el teléfono móvil está activo y transmitiendo mensajes en tiempo real.	Estado normal de operación; no requiere ninguna acción.
Estado: `Detenido` / `Fallido`	Indica que la sesión perdió autorización con el teléfono o sufrió un bloqueo de red.	Pulsar `Recrear sesión` y volver a vincular con QR o código de 8 caracteres.
Botón `Recrear sesión`	Reinicia desde cero la sesión técnica del conector `Waha` conservando intacto el historial de chats.	Úsalo siempre que el código QR no cargue o el estado quede congelado en `Fallido`.
Botón `Generar código QR`	Muestra el código visual en pantalla para escanear con la cámara del celular en un plazo de 60 segundos.	Método principal cuando tienes el teléfono móvil en la mano frente a la computadora.
Botón `Generar código de emparejamiento`	Genera una clave de 8 caracteres para vincular el teléfono sin usar la cámara.	Úsalo cuando la cámara no enfoca o cuando el dueño del celular está a distancia.
`Sincronización global de mensajes`	Importa bajo demanda al Inbox los mensajes alojados en el aparato móvil de las `Últimas 24 horas` o `Últimos 7 días`.	Ejecútalo inmediatamente después de recuperar una sesión que estuvo caída varias horas.
Sección `Chats` (`Status`, `Groups`, `Channels`, `Broadcast`, `Multimedia grupos`)	Interruptores individuales (`On`/`Off`) para permitir o bloquear la entrada de estados, grupos, canales y archivos pesados de grupos.	Mantén `Status`, `Channels` y `Broadcast` en `Off` para no saturar la sesión ni llenar la bandeja de ruido.
Sección `Proxy` (`Servidor`, `Usuario`, `Contraseña`)	Permite configurar un proxy cuando tu infraestructura lo requiera.	Déjala vacía salvo que tu implementación necesite uno y cuentes con los datos provistos por tu administrador.

Otras formas de detectar y gestionar el problema rápidamente

Inspección rápida de chats sin respuesta tras reconectar: Una vez que ejecutes Sincronizar mensajes, ve a la barra lateral izquierda y entra en Conversaciones → Desatendido (o Mensajes no leídos). Allí verás agrupados todos los clientes que quedaron esperando respuesta durante el corte.
Ordenamiento por espera real: En la parte superior de la lista de conversaciones, haz clic en el botón de flechas ↑↓ y en Ordenar por selecciona Esperando respuesta desde. Esto pondrá arriba de todo al cliente que lleva más horas esperando desde que ocurrió la desconexión.
Migración hacia WhatsApp Oficial sin perder historial (Migrar bandeja): Si tu volumen de mensajes creció tanto que no quieres depender nunca más de un teléfono encendido, puedes crear un canal de WhatsApp Cloud API (Oficial de Meta) y pulsar el botón Migrar bandeja en la esquina superior derecha de Ajustes → Entradas para transferir todas las conversaciones históricas de la bandeja De (antigua) hacia la bandeja A (nueva).

Prevención y cómo combinarlo con otras funciones de Waclis Inbox

Para evitar desconexiones sorpresivas y proteger la continuidad de tu atención comercial, aplica estas configuraciones dentro de Waclis Inbox:

Desactiva la recepción de Estados y Canales en Configuración de sesión: En el bloque Chats, asegúrate de que Status y Channels estén desactivados (Off). Cuando un número recibe cientos de estados de contactos y videos pesados de grupos que nadie atiende, el consumo de memoria de la sesión vinculada aumenta innecesariamente; si además trabajas con grupos pero no necesitas sus videos pesados, deja apagado Multimedia grupos.
Enruta las conversaciones reabiertas tras la sincronización: Combina la Sincronización global de mensajes con una regla en Ajustes → Automatización basada en el evento Conversación actualizada o Mensaje creado para que los chats recuperados se asignen automáticamente al Último agente que respondió o al equipo de guardia.
Usa intervalos seguros y Spintax en campañas por QR: Muchas "desconexiones repentinas" son en realidad cierres forzados por los sistemas anti-spam de WhatsApp tras detectar ráfagas de mensajes idénticos. Si envías campañas desde una bandeja Waha, utiliza siempre variaciones Spintax ({Hola|Buen día|Qué tal}), mantén intervalos aleatorios de 25 a 45 segundos y activa Rotar envío entre varias bandejas.

Relación con el ecosistema Waclis

Mantener tu bandeja de WhatsApp conectada en estado Operativo impacta directamente en las demás herramientas de tu cuenta en el ecosistema Waclis:

Waclis (Tienda Online / Carrito Cotizador): Si tu tienda online envía las confirmaciones de pedidos del Carrito Cotizador al WhatsApp del comprador a través de tu bandeja de Waclis Inbox, una sesión desconectada impedirá que ese mensaje automático salga hasta que restablezcas la vinculación.
WaclisPOS: Al reconectar la sesión de WhatsApp en Waclis Inbox, tus vendedores pueden volver a compartir presupuestos y comprobantes en PDF con los clientes (o retomar envíos configurados por API REST).
WaclisCAL y Agente de IA Capitán: Con la bandeja activa, tus agentes y Capitán pueden volver a compartir enlaces públicos de reserva de WaclisCAL en el chat (o ejecutar Herramientas personalizadas HTTP si tu cuenta las tiene configuradas). Recuerda que al importar mensajes atrasados con Sincronización global de mensajes, puedes apoyarte en Copilot dentro del chat para resumir y responder más rápido la cola acumulada.
Waclis Reach: Si ejecutas secuencias comerciales salientes desde Waclis Reach apoyadas en tus bandejas de Waclis Inbox, verifica que la sesión QR esté Conectado antes de activar una secuencia para evitar envíos fallidos.

Casos bordes adicionales y cómo resolverlos

1. El código QR gira indefinidamente y nunca termina de mostrarse

Síntoma: Haces clic en Generar código QR, aparece el indicador de carga pero el cuadro queda en blanco o vuelve a cerrarse.
Causa probable: La sesión interna quedó bloqueada en un estado intermedio tras un intento de conexión fallido anterior.
Cómo resolverlo: Haz clic primero en el botón Desconectar (si está activo), luego pulsa Recrear sesión, espera 5 segundos a que se reinicie el contenedor, haz clic en Actualizar y finalmente pulsa Generar código QR o Generar código de emparejamiento.

2. La sesión se conecta pero vuelve a caer a los pocos minutos

Síntoma: Escaneas el QR, el estado pasa a Operativo, pero 10 o 15 minutos después vuelve a figurar Detenido o Fallido.
Causa probable: El teléfono móvil tiene activado un modo agresivo de Ahorro de batería que corta los datos en segundo plano de WhatsApp al bloquearse la pantalla, o tienes otra plataforma externa intentando conectarse a la misma sesión al mismo tiempo.
Cómo resolverlo: En los ajustes de batería de tu celular (Android/iOS), configura la aplicación WhatsApp / WhatsApp Business como "Sin restricciones de batería en segundo plano" y verifica en Dispositivos vinculados que no haya otro bot externo compitiendo por la línea.

3. Al sincronizar mensajes entran decenas de grupos de WhatsApp que ensucian la bandeja

Síntoma: Ejecutas Sincronizar mensajes y de pronto la vista de Todas las conversaciones se llena de charlas de grupos internos o familiares.
Causa probable: El interruptor Groups estaba encendido (On) en la sección Chats de Configuración de sesión.
Cómo resolverlo: Ve a Configuración de sesión → sección Chats, apaga el interruptor Groups (Off) si no deseas atender grupos en Waclis Inbox, o bien utiliza la subvista dedicada Conversaciones → Grupos en la barra lateral izquierda y asegúrate de que en Capitán → Configuración → Ignorar contactos esté activado Ignorar grupos de WhatsApp.

Preguntas frecuentes (FAQ)

¿Si cierro la pestaña de Waclis Inbox en mi computadora se desconecta el WhatsApp?

No. A diferencia del WhatsApp Web clásico, la sesión del conector Waha vive en los servidores en la nube de Waclis Inbox. Todos los agentes pueden apagar sus computadoras al final del día y el canal seguirá conectado recibiendo mensajes y ejecutando automatizaciones o respuestas de Capitán las 24 horas, siempre que el teléfono móvil mantenga conexión a internet y no se cierre la sesión desde Dispositivos vinculados.

¿Qué pasa si pulso "Recrear sesión"? ¿Se borran mis contactos o conversaciones anteriores?

No se borra absolutamente nada. El botón Recrear sesión únicamente reinicia el túnel de conexión técnica con WhatsApp para generar un código QR limpio. Todas tus conversaciones, notas privadas, etiquetas, tarjetas Kanban y fichas de contactos permanecen intactas en Waclis Inbox.

¿Si ejecuto "Sincronizar mensajes" de los últimos 7 días se van a duplicar los mensajes que ya habían entrado?

No. El motor de Sincronización global de mensajes verifica el identificador único de cada mensaje de WhatsApp antes de importarlo. Solo agregará a las conversaciones aquellos mensajes que no existían previamente en Waclis Inbox, manteniendo la línea de tiempo limpia y sin duplicados.

¿Puedo seguir usando WhatsApp desde el teléfono celular mientras está conectado por QR a Waclis Inbox?

Sí. Puedes ver y enviar mensajes tanto desde el celular como desde Waclis Inbox. Además, los mensajes que respondas manualmente desde el teléfono móvil también se sincronizan y quedan registrados en el hilo de la conversación dentro de Waclis Inbox.

¿Necesitas más ayuda?

Si este artículo no resolvió tu consulta, nuestro equipo puede ayudarte personalmente.

Soporte por WhatsApp