Conectar WhatsApp Web por emparejamiento de QR

Conversa Labs

Última actualización el 13 de oct de 2026

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.

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