Visión general
El canal WhatsApp Web conecta un número de WhatsApp sin usar la API oficial de Meta: emparejas el número escaneando un código QR con la app del teléfono, igual que haces con WhatsApp Web en el navegador. Es la forma más rápida de empezar a atender por WhatsApp, ideal para números personales o pequeñas operaciones que aún no tienen una cuenta oficial (Cloud API).
Una vez emparejado, todos los mensajes recibidos y enviados empiezan a aparecer en las conversaciones de la plataforma, con multimedia, recibos de entrega/lectura y respuestas en tiempo real.
Requisitos previos
- Un rol de administrador para crear la bandeja.
- Un teléfono con WhatsApp instalado y el número que vas a conectar.
- El canal WhatsApp Web depende de un servicio de conexión habilitado para tu cuenta (aprovisionado por la operación). Si no ves este tipo de canal, habla con quien gestiona la operación.
- El teléfono necesita internet para mantener la sesión activa (como WhatsApp Web en el navegador).
Paso a paso
- En Configuración → Bandejas de Entrada, crea una nueva bandeja y elige WhatsApp.
- Selecciona el proveedor WhatsApp Web (emparejamiento por QR).
- Dale un nombre a la bandeja (p. ej. "WhatsApp Ventas").
- La plataforma muestra un código QR en la pantalla de configuración.
- En el teléfono, abre WhatsApp → Dispositivos vinculados → Vincular un dispositivo y apunta la cámara al QR.
- Espera la confirmación de emparejamiento — el número real se detecta automáticamente y la bandeja pasa al estado conectado.
- Asigna agentes/equipos y finaliza. Envía un mensaje de prueba para validar.
Configuración y opciones
- Estados de conexión: la bandeja muestra el estado actual de la sesión:
- Esperando emparejamiento: el QR se generó y espera ser escaneado.
- Conectado: la sesión está activa y el número atiende con normalidad.
- Desconectado: la sesión cayó temporalmente (p. ej. sin internet en el teléfono); se reconecta sola cuando es posible.
- Sesión cerrada (logout): la sesión se terminó. La bandeja informa la causa — sesión cerrada desde otro dispositivo (el caso normal cuando se activa la Coexistencia en ese número), el dispositivo principal cerró sesión (cambio de teléfono o bloqueo del número) o sesión cerrada por motivo desconocido. En los tres casos la corrección es la misma: empareja de nuevo escaneando un nuevo QR en la pantalla de conexión de la bandeja — y no se pierde nada.
- Reemparejar: si la sesión expira o se desconecta, genera un nuevo QR en la pantalla de la bandeja y vuelve a escanear.
- Rutas de salida opcionales: el proxy administrado y el dispositivo propio solo aparecen en la pestaña Conexión cuando la función correspondiente está habilitada para la cuenta. Si ninguna está habilitada, la bandeja usa la salida del servidor y la pantalla no muestra controles inactivos.
- Actividad en tiempo real: el panel muestra cuando el contacto está escribiendo o grabando un audio. En grupos, muestra el participante que realiza la acción.
- Multimedia: imágenes, videos, audios, documentos y otros archivos pueden tener hasta 100 MB en WhatsApp Web. Este límite de la conexión por dispositivo no modifica los límites de WhatsApp Cloud. Las notas privadas siguen el límite general de adjuntos de la instalación.
- Sincronización del historial: después de emparejar o reconectar, los lotes grandes se importan de forma incremental en segundo plano. El equipo puede seguir atendiendo mientras aparece el historial.
- Contactos de grupos (pestaña Recursos): dos opciones independientes lo controlan — Sincronizar contactos (importa la lista de miembros; desactivado por defecto) y Crear contactos para quienes envían mensajes en grupos/comunidades (activado por defecto). Para no tener ningún participante en tu lista de contactos, desmarca las dos. Detalles — y la lista de ignorados por bandeja — en Lista de ignorados y sincronización de contactos.
Casos de uso
- Empezar a atender por WhatsApp en minutos, sin proceso de aprobación de Meta.
- Conectar un número personal o de equipo pequeño que aún no es una cuenta oficial.
- Operar mientras la cuenta oficial (Cloud API) está en proceso de verificación.
Consejos, límites y buenas prácticas
- Anti-ban: respeta los límites de WhatsApp. Evitar envíos masivos, mensajes idénticos repetidos y agregar muchos contactos nuevos a la vez reduce el riesgo de bloqueo. La plataforma aplica un control de envío (throttle) por número para suavizar los picos.
- Mantén el teléfono conectado a internet; si queda offline mucho tiempo, la sesión cae.
- Funciones interactivas avanzadas (botones, listas) pueden requerir una licencia específica del servicio de conexión.
- Para volumen alto y la insignia verde oficial, considera migrar a WhatsApp Cloud.
Solución de problemas
- “No hay ningún servicio de WhatsApp Web disponible”: no hay una instancia de conexión activa y online disponible para crear la bandeja. No es un problema del número ni de la elección del proxy; pide al operador de la plataforma que revise los gateways e inténtalo más tarde.
- “Las credenciales del servicio de WhatsApp Web no son válidas”: el gateway rechazó su credencial operativa. El operador de la plataforma debe corregirla; el administrador de la cuenta no debe cambiar el número ni recrear la bandeja para evitar el error.
- El QR no se escanea: genera un nuevo QR (expira) e inténtalo de nuevo con buena iluminación.
- Pasó a "desconectado": revisa el internet del teléfono; la sesión debería volver sola.
- Estado "logout": el dispositivo se eliminó en el teléfono — empareja de nuevo.
- Quedó en "logout" justo después de activar la Coexistencia (Cloud) en ese número: es el comportamiento esperado — activar la Coexistencia desvincula todos los dispositivos vinculados de WhatsApp Business. Genera un nuevo QR en la pantalla de conexión de la bandeja y empareja de nuevo. No se pierde nada: se reutiliza la misma bandeja — número, conversaciones, contactos e historial se mantienen.
- La bandeja se emparejó, pero no llega nada: el número puede haber quedado atascado en un número provisional (placeholder) porque otra bandeja ya usa ese número — en la misma cuenta (mismo proveedor) o en otra cuenta. La pantalla de emparejamiento muestra el motivo. Libera o elimina la bandeja que retiene el número y empareja de nuevo.
- Los mensajes no llegan: confirma que la bandeja está conectada y que el número no fue bloqueado por WhatsApp.
- El historial sigue incompleto después de reconectar: espera a que termine la importación en segundo plano; las cuentas con mucha actividad pueden llegar en varios lotes. No vuelvas a emparejar durante la importación.