## 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

1. En **Configuración → Bandejas de Entrada**, crea una nueva bandeja y elige **WhatsApp**.
2. Selecciona el proveedor **WhatsApp Web** (emparejamiento por QR).
3. Dale un nombre a la bandeja (p. ej. "WhatsApp Ventas").
4. La plataforma muestra un **código QR** en la pantalla de configuración.
5. En el teléfono, abre WhatsApp → **Dispositivos vinculados** → **Vincular un dispositivo** y apunta
   la cámara al QR.
6. Espera la confirmación de emparejamiento — el número real se detecta automáticamente y la bandeja
   pasa al estado **conectado**.
7. 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](/hc/ajuda/articles/inboxes-channels-whatsapp-web-lista-ignorados-es).

## 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.

## Ver también

- [WhatsApp Cloud con Embedded Signup](/hc/ajuda/articles/inboxes-channels-whatsapp-cloud-embedded-signup-es)
- [Bandeja híbrida de WhatsApp: Coexistencia (Cloud) + WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-es)
- [WhatsApp Hub: grupos, comunidades, canales y estados](/hc/ajuda/articles/inboxes-channels-whatsapp-hub-grupos-comunidades-canais-status-es)
- [Configuración de bandeja](/hc/ajuda/articles/inboxes-channels-configuracoes-de-inbox-es)
- [Visión general de bandejas de entrada y canales](/hc/ajuda/articles/inboxes-channels-overview-es)