WhatsApp No Oficial (QR)

Disponible para perfil: Administrador · Requiere acceso a Administración → Canales. No necesitas cuenta WABA ni Business Manager para este modo.

Qué es WhatsApp No Oficial

WhatsApp No Oficial (QR) simula una sesión de WhatsApp Web / Desktop y la vincula a ChatCielo mediante un QR Code escaneado con tu celular. No usa la API Oficial de Meta (WABA / Cloud API) ni pasa por OAuth: es una conexión directa entre tu número y el panel.

Técnicamente depende de un motor no oficial que mantiene la sesión web activa. ChatCielo soporta varios motores con la misma experiencia de QR:

Motor	Notas
Baileys	El más usado para el modo híbrido y respaldo. Soporta código de pareamento si no puedes escanear QR.
WhatsMeow	Alternativa estable basada en Go; buen rendimiento en tenants con alto volumen.
Evolution API	Autoalojada (tu VPS). Requiere URL + Global API Key configuradas en Configuraciones → Integraciones.
WebJS / wwebjs	Basado en navegador headless; útil para pruebas rápidas.
Uazapi / Z-API / Wuzapi	Proveedores externos no oficiales; requieren token/URL del proveedor.

Todos aparecen en el selector Tipo de Canal como opciones No Oficial / QR Code. El flujo de QR es idéntico: el motor solo cambia la estabilidad y dónde se aloja la sesión.

Diferencia con Oficial y Coexistencia

Aspecto	No Oficial (QR)	Oficial WABA — Cloud API	Oficial con Coexistencia (OAuth)
Conexión	QR escaneado con el celular	Token + credenciales de Meta en Cloud	OAuth de Meta (pop-up) + aprobación en el celular
Número en el celular	Debe permanecer conectado	No necesita celular (número en la nube)	Sigue activo en el celular y en el panel a la vez
Requiere BM / WABA	No	Sí (Business Manager + tarjeta)	Sí
Plantillas aprobadas	No (solo mensajes libres dentro del flujo)	Sí	Sí
Riesgo de ban	Mayor si hay spam o volumen agresivo	Muy bajo (oficial)	Muy bajo
Costo por mensaje Meta	No paga a Meta (paga hosting/proveedor del motor)	Sí, según tarifa WABA vigente	Sí
Ventana de 24 h	No aplica (sesión continua mientras el celular esté conectado)	Aplica	Aplica
Ideal para	Pruebas, respaldo híbrido, segundo número de handoff	Operación principal productiva	Operación que necesita móvil + panel simultáneos

Regla de oro: usa No Oficial para probar rápido o como respaldo híbrido de un WABA. No lo uses como canal principal si tu operación supera 2k–3k mensajes/día sin opt-in claro: el riesgo de bloqueo del número es real.

Cuándo usarlo

Úsalo cuando:

Necesitas probar ChatCielo hoy sin crear WABA ni verificar empresa en Meta.
Quieres activar el Modo Híbrido — el No Oficial es el que responde sin cobro por mensaje y hace fallback automático al oficial si se cae. Ver Modo Híbrido.
Quieres aislar un segundo número para handoff (Forma 2 — Dos números) sin comprar otro WABA.
Haces demos, QA o pilotos con números de prueba.

Evítalo cuando:

Enviarás campañas masivas / marketing sin opt-in comprobado (usa WABA + plantilla aprobada).
Necesitas garantía de entrega y soporte de Meta (usa WABA Cloud o Coexistencia).
Tu número ya es WABA exclusivo en otro BSP — un número solo puede estar en una API Oficial a la vez; el QR no oficial sobre el mismo número interferirá.

Limitaciones del No Oficial

Depende del celular encendido y con internet. Si el celular se apaga, pierde datos o se abre WhatsApp Web en otro navegador, la sesión se cae y el canal queda Desconectado.
Reconexión periódica. Algunos motores piden re-escanear QR cada 14–30 días o tras caída de sesión. Activa notificaciones para no perder mensajes.
Sin plantillas oficiales ni ventana de Meta. No puedes iniciar conversación fuera de ventana con template aprobado; si el contacto no te escribió primero, el mensaje puede no entregarse.
Sin llamadas WABA. Igual que coexistencia, no habilita llamadas oficiales.
Riesgo de ban si abusas. Envíos masivos sin opt-in, listas compradas o denuncias de spam pueden llevar a bloqueo temporal o permanente del número por WhatsApp.
No es WABA. No aparece como cuenta verificada ni suma al score oficial de calidad de Meta.

Pasos: conectar por QR

Abre Canales y elige el motor No Oficial

Entra como administrador a Administración → Canales.
Haz clic en Agregar Canal (o Adicionar Canal).

Menú lateral Administración → Canales — Administración → Canales: vista donde se listan las conexiones activas.

En Tipo de Canal selecciona WhatsApp No Oficial — elige el motor: Baileys, WhatsMeow, Evolution API, WebJS, Uazapi/Z-API según tu setup.

Selector Tipo de Canal con opciones no oficiales — Adicionar Canal → selecciona el tipo No Oficial / QR Code (Baileys, WhatsMeow, Evolution, etc.).

Completa Nombre del canal (ej. Soporte QR o Híbrido Baileys) y, si usas Evolution/Z-API/Uazapi, pega URL + API Key/Token del proveedor.

Formulario Adicionar Canal con nombre y tipo — Nombre del canal y credenciales del motor (solo Evolution/Z-API/Uazapi requieren URL y clave).

Evolution API autoalojada: antes de este paso, configura Configuraciones → Integraciones → Evolution API con tu URL y Global Key. Verifica el estado en una nueva pestaña antes de crear el canal.

Genera el QR Code

Haz clic en Crear / Guardar. El panel genera un QR Code único.

Modal con QR Code generado — Canal creado → se genera el QR Code para vincular. Tiempo de expiración ~30–60 segundos.

Si no puedes escanear QR: en Baileys / WebJS / Meow puedes usar Código de pareamento: ingresa el número en formato internacional (+54 9 11..., +34 612... sin espacios ni guiones) y recibe el código de 8 dígitos en el celular para vincular.

Escanea con el celular

Abre WhatsApp (o WhatsApp Business) en el celular que tiene ese número.
Ve a Ajustes → Dispositivos vinculados → Vincular un dispositivo.
Apunta la cámara al QR del panel y confirma.

Celular escaneando QR — WhatsApp → Dispositivos vinculados → Vincular dispositivo → escanea el QR del panel.

Verifica estado Conectado y prueba

El canal debe pasar a Conectado (punto verde) en Administración → Canales.

Canal en estado Conectado — Estado esperado: Conectado. Si ves Desconectado o QR expirado, regenera.

Envía un mensaje desde un número externo a este WhatsApp.
Verifica que llega a Pendientes / Atenciones de ChatCielo en menos de 5 segundos.
Responde como atendente y confirma que el contacto lo recibe.

¡Listo! Ya puedes atender, crear ChatFlows y probar automatizaciones sin tocar la API Oficial.

Configuración recomendada tras conectar

Fila / ChatFlow por defecto: en Editar canal asigna la Fila y el Flow (BOT) que atenderá este número.
Mensaje de despedida y palabra clave de cierre automático: configúralos en el mismo formulario del canal.
Recursos: habilita según tu operación: Evaluación automática, Transcripción de audio (Google Speech-to-Text), Auto-distribuir, Posición en fila.
Proxy (solo si lo necesitas): en Baileys/WebJS/Meow/Evolution/Uazapi puedes activar Usar Proxy con URL http://IP:PUERTO + usuario/contraseña. Úsalo solo si tu IP está bloqueada o necesitas geo-distinto; evita proxies gratuitos en producción.
Importar mensajes del dispositivo (solo Baileys): importa el historial al crear el canal. Durante la importación, desactiva ChatFlow/bots y mantén el horario de atención abierto — todos los mensajes importados disparan automatizaciones.

Troubleshooting

Problema	Causa probable	Qué hacer
QR expira o no carga	Timeout de ~30–60 s, mala conexión o pop-up bloqueado	Haz clic en Generar nuevo QR, verifica internet del celular y que el navegador permita pop-ups. Acerca el celular y escanea rápido.
Sesión caída / Desconectado al día siguiente	Celular apagado/sin internet, WhatsApp Web abierto en otro navegador, o sesión expirada	Mantén el celular encendido, con datos/Wi-Fi y sin protector de pantalla agresivo. No abras WhatsApp Web con el mismo número en otra pestaña. Archiva chats antiguos en el celular y reconecta con Nuevo QR.
Número baneado / bloqueo temporal	Envíos masivos sin opt-in, denuncias de spam, listas compradas	Pausa campañas inmediatamente. Revisa plantillas y consentimiento. Si es ban temporal, espera el plazo de WhatsApp y reconecta. Si es permanente, usa un número nuevo y migra a WABA oficial para campañas.
No aparecen mis Evolution/Z-API/Uazapi	URL o Global Key incorrectas, firewall/VPS caído	Prueba la URL en una pestaña nueva (`/health` o `/status`). Verifica que la API responda y que la clave coincida con Configuraciones → Integraciones. Re-genera el token si expira.
Mensajes no llegan al panel pero sí al celular	Webhook no revalidado o canal en modo Contingencia inactivo	En Canales → ⋯ → Revalidar Webhook (Evolution/Meow/Uazapi/Z-API) y verifica que Contingencia esté activa en Editar canal.
No puedo usar el mismo número en WABA y QR a la vez	WABA exclusivo no permite coexistencia sin modo híbrido	Si tu número ya está en WABA Cloud/OAuth, no crees un QR del mismo número salvo para Modo Híbrido — Forma 1 Coexistência (mesmo número). Sigue la guía de Modo Híbrido.

Reconexión y buenas prácticas: desactiva ahorro de batería agresivo en Android/iOS para WhatsApp, deja el celular enchufado durante pruebas largas, usa Chrome/Windows para escanear y evita cerrar la sesión desde el celular (“Cerrar sesión en todos los dispositivos”) a menos que quieras forzar un nuevo QR.

Siguiente paso: modo híbrido

Con el canal No Oficial Conectado, ya puedes ahorrar en la nueva cobranza de Meta:

Ve a Administración → Canales → Editar tu canal WABA → sección Modo Híbrido.
Elige Coexistência (mesmo número) si el QR es del mismo número, o Dois números (handoff) si es un segundo número.
Selecciona este canal como Canal vinculado y guarda.

Sigue el paso a paso completo en Modo Híbrido — Ahorra en la nueva cobranza de Meta.

¿Tu número debe seguir en el celular y en el panel a la vez con API Oficial? Ver WhatsApp con Coexistencia (OAuth).

Fuentes

Fuente primaria: Canais de comunicação — listado oficial de tecnologías (Meta Oficial vs WhatsApp não oficial: Baileys, WebJs, Evolution, Wuzapi, Z-API, Uazapi).
Paso a paso QR: Como conectar um canal (sessão/número) — flujo Adicionar Canal, elección de tipo, código de pareamento, recursos y proxy.
Comparativa detallada: API Oficial vs. APIs Não Oficiais: Guia Completo.

Traducción y adaptación a ChatCielo por el equipo de docs. Nombres de motores y etiquetas de UI se mantienen como aparecen en el panel (Baileys, WhatsMeow, Evolution, WebJS, Uazapi, Z-API).