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

- **Elección de conexión al crear**: selecciona **Sin proxy (conexión directa)**, **Proxy de conexión gestionado** o **Usar mi teléfono**. La ruta directa está disponible sin proveedores; el proxy requiere capacidad y el teléfono requiere un dispositivo configurado. Si el proxy elegido deja de estar disponible, la creación informa del fallo y no cambia a conexión directa.
- **Recursos antes y después de crear**: el asistente y la pestaña **Recursos** muestran los mismos controles de grupos, canales, recepción y publicación de Estados, presencia, historial y medios, contactos y rechazo de llamadas. Recibir y publicar Estados son opciones independientes. Los valores iniciales usan los valores de la plataforma; las opciones visibles se aplican a la nueva bandeja. **Restaurar valores de la plataforma** deshace las ediciones del asistente. Los cambios en Recursos requieren **Guardar cambios** y permanecen al recargar la página.
- **Respuestas y reacciones a tu Estado**: cuando un contacto responde o reacciona a un Estado publicado por ti — desde el compositor, una difusión del Hub o el propio teléfono — el mensaje aparece en la conversación del contacto con la tarjeta **Tú · Estado**, mostrando la leyenda y la miniatura del Estado original aunque WhatsApp no envíe la miniatura junto con la respuesta. Los Estados publicados quedan registrados por bandeja con el medio enviado y siguen disponibles después de las 24 horas en que WhatsApp los muestra. No se crea ningún contacto ni conversación para el propio Estado.

- **Desconectar**: pausa la conexión y mantiene el dispositivo vinculado. Puedes cancelar la confirmación sin cambiar la sesión y reconectar después. Si la solicitud falla, la pantalla muestra el error y permite reintentar.

- **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**: genera un nuevo QR cuando la pantalla de **Conexión** confirme que es necesario un
  nuevo emparejamiento. Una observación de estado ausente, vencida o inválida no prueba que la sesión
  expiró o cayó. La solicitud de reconexión puede fallar, y solo una nueva confirmación conectada muestra
  que la sesión volvió.
- **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).

### Estado de la sesión en la conversación

Al abrir o actualizar una conversación de esta bandeja Web — incluso cuando es el miembro Web de un par
híbrido — la plataforma lee la última observación disponible. El aviso aparece en esa apertura o
actualización; no promete una alerta inmediata de una sonda ni un seguimiento continuo de una pestaña que
ya está abierta.

Solo una observación reciente que confirme que la sesión está fuera muestra **“WhatsApp Web no tiene una
sesión activa desde las {fecha y hora}”**, en la zona horaria de la cuenta. Si el episodio empezó en otro
día, la fecha acompaña la hora. Mientras la indisponibilidad esté confirmada, los mensajes que requieren
Web no se enviarán. Esto no informa una entrega anterior, no reenvía un mensaje ni confirma fallback o
reintento por otro transporte.

Una observación ausente, vencida, inválida o no disponible es un **estado desconocido**, no una
desconexión. Quien atiende ve el contexto y busca a un administrador; no recrees la bandeja, no borres el
historial ni cierres la sesión para resolver ese estado. Cuando tenga permiso, el administrador abre la
**Conexión** existente de la bandeja. Pedir reconexión puede fallar; solo una nueva confirmación conectada
elimina el aviso.

Un correo administrativo, cuando se envía sobre una indisponibilidad conocida, no prueba recuperación,
entrega de mensajes ni una actualización de la conversación ya abierta.

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

### Productos, pedidos y pagos en la conversación

Los mensajes comerciales de WhatsApp muestran el tipo de tarjeta, los artículos, las cantidades y los importes disponibles. Las actualizaciones de pedidos y pagos tienen estados separados. “Pago informado” muestra lo que el remitente declaró en el mensaje; no transfiere fondos ni concilia un cobro.

Use **Ver detalles** para consultar la referencia, los ajustes y las instrucciones incluidos en ese mensaje. Una actualización sin importe no recibe un total supuesto de otro mensaje. Las respuestas citadas identifican el pedido o la solicitud de pago, y las miniaturas compactas evitan ampliar imágenes de baja resolució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)