Centro de ayuda›Inbox›Canales y bandejas de entrada›Artículo
Artículo de ayuda · Waclis

Conexión de WhatsApp: diferencias entre código QR y Cloud API oficial

Actualizado: 03/11/2026 Publicado: 18/09/2026
  • Categoría: Canales y bandejas de entrada
  • Disponibilidad: Incluido en todos los planes (Estándar, Premium y Evolución)
  • Tiempo estimado de lectura: 8 minutos
  • Rol necesario: Administrador (para crear bandejas) / Cualquier usuario (consulta operativa)

WhatsApp es el canal de comunicación con mayor tasa de apertura y respuesta en Latinoamérica. Para adaptarse a distintas etapas operativas, presupuestos y arquitecturas comerciales, Waclis Inbox ofrece dos modalidades nativas para conectar tus líneas de WhatsApp: WhatsApp mediante código QR (Conexión rápida) y WhatsApp Oficial (Meta Cloud API). En esta guía analizamos en profundidad sus diferencias técnicas, costos asociados, reglas de ventana de atención, soporte de grupos, plantillas y criterios prácticos para elegir la opción ideal o combinar ambas en tu cuenta.

1. ¿Qué puedes hacer y cuándo te sirve?

Comprender cómo opera cada modalidad te permite diseñar una estrategia de atención y ventas sólida antes de vincular tus números telefónicos:

  • Escenario 1 — Comercio minorista o equipo de ventas consultivas (Conexión por código QR): Una tienda de indumentaria o distribuidora quiere que cinco vendedores atiendan desde sus computadoras el mismo número de WhatsApp Business que hoy usan en un teléfono físico, conservando la posibilidad de iniciar conversaciones de texto libre con clientes en cualquier momento sin pagar cargos por mensaje a Meta.
  • Escenario 2 — Empresa mediana o corporativa con alto volumen transaccional (Meta Cloud API): Una clínica médica, empresa de software o marca de comercio electrónico necesita una línea de soporte y notificaciones alojada en los servidores oficiales de Meta, que no dependa de un teléfono físico encendido, permita solicitar la insignia verificada de cuenta comercial y envíe miles de confirmaciones mediante plantillas estructuradas.
  • Escenario 3 — Estrategia híbrida o coexistencia: Una organización utiliza una bandeja de WhatsApp Oficial (Cloud API) para su canal central de atención al cliente e integración con el Agente de IA Capitán, mientras mantiene bandejas adicionales de WhatsApp mediante código QR para que sus ejecutivos de cuentas clave gestionen grupos de WhatsApp con clientes mayoristas.

2.Cómo se identifican ambas opciones en la interfaz de Waclis Inbox

Cuando ingresas a Ajustes → Entradas → + Añadir bandeja de entrada y haces clic en el icono de WhatsApp, Waclis Inbox despliega el selector de proveedor con dos tarjetas específicas. Es fundamental conocer la correspondencia entre el nombre comercial de cada modalidad y el nombre técnico que verás en pantalla:

Concepto comercial en el Centro de Ayuda Tarjeta a elegir en el asistente (Paso 2) Etiqueta (Badge) en el listado de Entradas
WhatsApp Oficial (Meta Cloud API) WhatsApp Business (Aprovisiona números nuevos mediante el flujo de registro incrustado de Meta) o enlace flujo de configuración manual WHATSAPP CLOUD
WhatsApp mediante código QR (Conexión rápida) Waha (con insignia Beta — Conectar mediante la API de Waha) WAHA
Importante: Cuando desees conectar tu teléfono escaneando un código QR o ingresando un código numérico de 8 caracteres, debes seleccionar siempre la tarjeta Waha dentro del asistente de WhatsApp. Ese es el nombre técnico del motor de vinculación multidispositivo integrado en Waclis Inbox.

3. Comparativa exhaustiva: Código QR (Waha) vs. WhatsApp Oficial (Meta Cloud API)

La siguiente matriz compara punto por punto el comportamiento técnico, comercial y operativo de ambas alternativas verificadas en Waclis Inbox:

Dimensión operativa WhatsApp mediante código QR (Waha) WhatsApp Oficial (WhatsApp Business / Cloud API)
Arquitectura de conexión Funciona como un dispositivo vinculado adicional de la aplicación móvil WhatsApp o WhatsApp Business instalada en tu teléfono. Conexión directa en la nube con los servidores de Meta mediante el protocolo oficial Graph API / Webhooks.
Requisitos de alta Solo requiere el nombre de la bandeja, el número en formato +E.164 y escanear el QR desde el teléfono. Toma menos de 2 minutos. Requiere cuenta en Meta Business Suite, portafolio comercial configurado y validación del número por SMS o llamada de voz.
Dependencia de teléfono físico El teléfono principal debe conservar la cuenta activa y conectarse a internet periódicamente (como ocurre en WhatsApp Web). No depende de ningún teléfono físico. El número vive directamente en la infraestructura en la nube de Meta.
Ventana de atención de 24 horas Libre. Puedes responder o iniciar conversaciones con texto libre en cualquier horario sin restricción del editor. Estricta. Pasadas 24 horas desde el último mensaje del cliente, el editor bloquea el texto libre y exige enviar una Plantilla Meta aprobada.
Costos por mensaje de Meta $0 adicionales en Meta. Utiliza tu línea móvil habitual sin cargos por plantilla ni facturación por conversación en Meta Business. Aplica tarifario oficial de Meta. Meta cobra por cada conversación iniciada con plantilla según el país del destinatario y la categoría (Marketing, Utilidad o Autenticación).
Uso de plantillas vs. Spintax No requiere plantillas aprobadas. En campañas permite texto libre con variables dinámicas y variaciones Spintax (`{Hola Buenas Qué tal}`). Exige usar plantillas creadas y aprobadas previamente por Meta desde Ajustes → Plantillas Meta.
Sincronización de historial previo Sí. Incluye la herramienta Sincronización global de mensajes para importar chats de las Últimas 24 horas o Últimos 7 días. No. Por diseño de la API de Meta, solo recibe los mensajes entrantes que ocurran a partir del momento en que se registra el webhook.
Soporte de Grupos de WhatsApp Sí. Permite activar la recepción de grupos y organizarlos en la pestaña Grupos de la barra lateral de conversaciones. No. La API oficial de Meta para empresas solo admite conversaciones individuales uno a uno con clientes.
Estados, Canales y Difusión Permite filtrar o permitir estados (Status), canales (Channels) y listas de difusión (Broadcast) desde Configuración de sesión. No recibe estados de contactos ni participa en canales de difusión móviles.
Monitoreo de salud y límites Muestra estado de sesión en vivo (Operativo, Conectado, Detenido, Fallido) y permite configurar un Proxy cuando tu infraestructura de red lo requiera. Incluye pestaña Salud de la Cuenta con semáforo de calidad (Verde, Amarillo, Rojo) y escalas de límites de Meta (250, 1K, 10K, 100K, Ilimitados).
Uso simultáneo en el celular Puedes seguir viendo y usando WhatsApp en tu teléfono normalmente mientras tu equipo atiende en Waclis Inbox. Solo permite seguir usando la app móvil WhatsApp Business si conectas el número bajo el modo de Coexistencia de Meta.

4. Análisis detallado de reglas críticas

4.1 La regla de la ventana de atención de 24 horas en Meta Cloud API

En WhatsApp Oficial (Meta Cloud API), cada vez que un cliente te envía un mensaje entrante se abre una ventana de servicio gratuita de 24 horas. Durante ese lapso, tus agentes o el Agente de IA Capitán pueden enviar tantos mensajes de texto libre, audios, imágenes o documentos como necesiten.

Si transcurren más de 24 horas desde el último mensaje escrito por el cliente, Waclis Inbox deshabilita automáticamente el campo de escritura libre en esa conversación y muestra el botón para seleccionar una Plantilla de WhatsApp. Una vez que envías la plantilla y el cliente responde, la ventana de 24 horas vuelve a abrirse. En cambio, en WhatsApp mediante código QR (Waha), esta restricción no existe y el compositor de texto libre permanece habilitado de forma permanente.

4.2 Costos operativos y facturación

  • En Waclis Inbox: Ambas modalidades están disponibles desde el plan Estándar (respetando el cupo de bandejas de entrada de tu suscripción en panel.waclis.com).
  • En Meta: Cuando utilizas WhatsApp Oficial, debes asociar un método de pago corporativo (tarjeta de crédito internacional) dentro de tu cuenta de Meta Business Suite. Meta factura directamente el envío de plantillas de Marketing, Utilidad (fuera de ventana) y Autenticación. Por el contrario, en WhatsApp mediante código QR (Waha) no interviene la facturación publicitaria de Meta.

4.3 Buenas prácticas de reputación en envíos salientes

Ninguna modalidad debe utilizarse para enviar correo no deseado (spam) a bases de datos compradas o contactos que no hayan solicitado información:

  • En WhatsApp mediante código QR (Waha), realizar envíos masivos repentinos e idénticos a números desconocidos puede activar los sistemas automatizados de prevención de abuso de WhatsApp y suspender la línea telefónica. Para mitigar este riesgo en envíos legítimos a tu cartera de clientes, Waclis Inbox incorpora intervalos aleatorios de espera (25s a 45s), variaciones de texto Spintax, pausa fuera de horario comercial y rotación entre múltiples bandejas.
  • En WhatsApp Oficial (Cloud API), si muchos destinatarios bloquean o reportan tu plantilla, la Calificación de calidad en la pestaña Salud de la Cuenta bajará de Verde (Alta) a Amarillo (Media) o Rojo (Baja), lo que puede pausar temporalmente la plantilla o reducir tu límite diario de envíos.

5. ¿Cómo pasar de una modalidad a otra sin perder el historial?

Es muy habitual que un negocio comience operando con WhatsApp mediante código QR (Waha) por su inmediatez y, meses más tarde, decida dar el salto a WhatsApp Oficial (WhatsApp Business) o cambiar de proveedor.

Para que no pierdas ni una sola conversación, nota interna ni etiqueta histórica al crear una nueva bandeja de entrada, Waclis Inbox cuenta con la herramienta nativa Migrar bandeja:

  1. Ve a Ajustes (icono de engranaje) → Entradas.
  2. Crea primero la nueva bandeja de entrada destino (por ejemplo, tu nueva conexión de WhatsApp).
  3. Regresa al listado principal de Ajustes → Entradas y haz clic en el botón Migrar bandeja ubicado en la esquina superior derecha.
  4. En el cuadro modal, elige en el selector De la bandeja anterior (origen) y en el selector A la bandeja nueva (destino).
  5. Haz clic en Migrar. Todas las conversaciones pasarán de forma íntegra a la nueva bandeja para que tus agentes continúen atendiendo con todo el contexto previo.

6. Cómo combinar ambos canales con otras funciones de Waclis Inbox

Independientemente de si conectas tu línea por código QR (Waha) o por API Oficial (WhatsApp Cloud), una vez creada la bandeja puedes potenciarla con todas las herramientas de productividad de la plataforma:

  • Reglas de automatización (Ajustes → Automatización): Crea reglas inmediatas o diferidas filtrando por el atributo Bandeja de entrada para asignar conversaciones al equipo de Ventas o Soporte, etiquetar por prefijo telefónico (Empieza con) o enviar avisos de seguimiento si el cliente no responde.
  • Agente de IA Capitán (Capitán → Asistentes): Vincula un asistente inteligente en la pestaña Configuración del bot de cualquiera de las dos bandejas para responder consultas frecuentes las 24 horas y derivar a un agente humano cuando sea necesario.
  • Encuestas de satisfacción (Encuestas de Satisfacción): En bandejas de WhatsApp Oficial, además del método Clásico (enlace en el chat), puedes seleccionar el método Plantilla WhatsApp (requiere aprobación) para evaluar la atención con botones nativos.

7. Relación con el ecosistema Waclis

Tus bandejas de WhatsApp (tanto por código QR como por API Oficial) son el motor de comunicación para el resto de las aplicaciones del ecosistema Waclis:

  • Waclis (Tienda Online / Carrito Cotizador): Los pedidos generados por tus compradores en la tienda se envían por WhatsApp e impactan en tu bandeja de Waclis Inbox para confirmar el pago y coordinar la entrega.
  • WaclisPOS: Permite enviar comprobantes de venta y presupuestos directamente al WhatsApp del cliente utilizando las bandejas conectadas en tu cuenta de Waclis Inbox.
  • WaclisCAL: Puedes compartir tus enlaces públicos de reserva en las conversaciones de WhatsApp o integrar tus flujos de agenda mediante API REST, Aplicaciones del panel o Herramientas personalizadas HTTP de Capitán.
  • Waclis Reach: Utiliza tus bandejas conectadas en Waclis Inbox para ejecutar secuencias comerciales salientes y se complementa con tus bandejas de Waclis Inbox cuando el prospecto responde.

8. Problemas frecuentes y cómo resolverlos

8.1 Busco la opción "Código QR" al crear la bandeja de WhatsApp pero no aparece ese nombre

  • Síntoma: Al entrar a Ajustes → Entradas → + Añadir bandeja de entrada → WhatsApp, ves las tarjetas WhatsApp Business y Waha, pero ninguna dice literalmente "Código QR".
  • Causa probable: En la interfaz técnica del selector de proveedores, el conector de código QR se identifica con el nombre Waha (acompañado de la etiqueta Beta).
  • Cómo resolverlo: Haz clic en la tarjeta Waha, completa el nombre y número de teléfono, crea el canal y luego abre la pestaña Configuración de sesión de esa bandeja para pulsar Generar código QR.

8.2 Quiero conectar el mismo número al mismo tiempo por QR y por Cloud API estándar

  • Síntoma: Intentas activar un número en Cloud API estándar sin desconectarlo de la app móvil tradicional o viceversa.
  • Causa probable: A menos que utilices el flujo específico de Coexistencia de Meta para WhatsApp Business App, un número registrado en Cloud API pura no puede operar simultáneamente como cuenta móvil normal sin coexistencia.
  • Cómo resolverlo: Si necesitas usar el teléfono móvil y la API Oficial a la vez, utiliza el registro incrustado de WhatsApp Business activando la opción de coexistencia compatible con Meta, o bien utiliza directamente una conexión mediante código QR (Waha).

8.3 En mi bandeja de WhatsApp Oficial no puedo escribirle a un cliente que habló ayer

  • Síntoma: El cuadro de respuesta aparece bloqueado indicando que debes enviar una plantilla.
  • Causa probable: Se cumplieron más de 24 horas desde el último mensaje enviado por el cliente, activándose la regla obligatoria de ventana de atención de Meta.
  • Cómo resolverlo: Haz clic en el icono de Plantillas de WhatsApp en el compositor, elige una plantilla aprobada de Utilidad o Marketing y envíala. Cuando el cliente responda, se habilitará nuevamente el texto libre.

9. Preguntas frecuentes (FAQ)

¿Puedo tener una bandeja con código QR (Waha) y otra con WhatsApp Oficial (WhatsApp Cloud) en la misma cuenta de Waclis Inbox?

Sí. Puedes combinar ambas modalidades en la misma organización sin ningún inconveniente, asignando distintos números telefónicos a cada bandeja según la función comercial de cada línea.

¿Pierdo mi historial de chats de WhatsApp en el celular si conecto mi número por código QR (Waha)?

No. Al vincular tu línea mediante Waha, tu teléfono sigue siendo el dispositivo principal y conserva intactos todos tus chats. Además, desde Waclis Inbox puedes usar Sincronización global de mensajes para traer a la plataforma los mensajes de las últimas 24 horas o los últimos 7 días.

¿Cuál de las dos opciones me permite atender grupos de WhatsApp desde Waclis Inbox?

Únicamente WhatsApp mediante código QR (Waha). Desde la pestaña Configuración de sesión puedes encender el interruptor Groups en la sección Chats para recibir y responder mensajes de grupos en la carpeta Grupos de tu barra lateral.

¿En qué planes están incluidas ambas conexiones de WhatsApp?

Tanto el conector Waha (código QR) como WhatsApp Business (Meta Cloud API) están disponibles desde el plan Estándar, sujetos únicamente al límite total de bandejas de entrada contratadas en tu suscripción.

10. Artículos relacionados

¿Necesitas más ayuda?

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

Soporte por WhatsApp