Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nubea.com.ar/llms.txt

Use this file to discover all available pages before exploring further.

Si tu WhatsApp aparece como Desconectado en Nubea, o no podés completar la conexión inicial, revisá estas causas. Los flujos son distintos según el método — primero identificá si estás en QR o en API Oficial / Kapso, porque los problemas son diferentes.
Para saber cuál usás: panel → click en el nombre de tu marca → Configuración de WhatsApp. Ahí ves qué método tenés activo.

​
Si usás QR (WhatsApp Web)

​
1. Otra sesión escaneó el mismo número

WhatsApp permite solo una sesión web/desktop activa por número (con el modelo viejo) o hasta 4 (con multi-device). Si alguien escaneó el QR de WhatsApp en otra computadora, la sesión de Nubea puede ser desplazada. Cómo verificarlo:
  • Abrí WhatsApp en el celular → Configuración → Dispositivos vinculados.
  • Si ves un dispositivo “Chrome (Windows)” o “Safari (Mac)” que no es Nubea, ahí está el conflicto.
Cómo arreglarlo:
  • Cerrá sesión de los dispositivos que no usás (tocá el dispositivo → Cerrar sesión).
  • Volvé a Nubea y reescaneá el QR.

​
2. Tenés WhatsApp Web abierto al mismo tiempo

Si dejaste WhatsApp Web abierto en una pestaña del navegador, puede estar peleando con la sesión de Nubea por el slot de dispositivo vinculado. Cómo verificarlo: revisá si tenés web.whatsapp.com abierto en alguna pestaña. Cómo arreglarlo: cerrá WhatsApp Web. Reescaneá el QR en Nubea.

​
3. El celular se quedó sin internet

QR funciona como WhatsApp Web — necesita que el celular esté online para sincronizar (con multi-device el celular se puede apagar por algunas horas, pero no días). Cómo verificarlo:
  • Mirá el celular: ¿tiene wifi o datos?
  • ¿Estuvo apagado o sin señal varios días?
Cómo arreglarlo:
  • Reconectá el celular a internet y abrí WhatsApp.
  • Si pasó mucho tiempo, la sesión de Nubea puede haber expirado: reescaneá el QR.

​
4. La sesión expiró por inactividad o reinicio de servidor

A veces la sesión QR se cae por causas operativas (reinicio del worker de Nubea, actualización de Baileys, cambio de IP). No es un error del usuario. Cómo verificarlo: estado en Nubea dice Desconectado y nada del lado tuyo cambió. Cómo arreglarlo: generá un QR nuevo desde Nubea y reescanealo. Es la solución universal para QR.
Si el QR se cae varias veces por semana, es señal de que tu volumen o tu actividad está poniendo al número en riesgo. Considerá migrar a API Oficial — es más estable y sin riesgo de baneo.

​
Si usás API Oficial / Kapso

​
5. Meta Business no está verificado

Para usar la API Oficial en serio (más de 250 conversaciones al día), Meta exige que verifiques tu empresa en Business Manager. Si no está verificada, Meta puede bloquear envíos o no aprobar plantillas. Cómo verificarlo: entrá a business.facebook.com → Configuración del negocio → Información del negocio. Tiene que decir Verificado en verde. Cómo arreglarlo: completá el proceso de verificación de empresa. Necesitás documentación legal (constancia AFIP / IIBB, factura de servicio a nombre de la empresa). Tarda 1-7 días hábiles. Ver ampliar límite de mensajes.

​
6. El phoneNumberId está mal asignado o expiró

Cuando se conecta API Oficial, Nubea guarda un identificador de tu número (phoneNumberId). Si Meta lo invalida (por una migración, un cambio de WABA o un revoke de acceso), los envíos empiezan a fallar. Cómo verificarlo: panel → Configuración de WhatsApp. Si dice Desconectado o Error de credenciales, suele ser esto. Cómo arreglarlo:
  • Volvé a conectar desde Configuración de WhatsApp → API Oficial (Meta) → Activar plan. El flow va a refrescar las credenciales.
  • Si el error persiste, mandanos un mail con tu WABA ID y el número a ayuda@nubea.com.ar y lo escalamos con Kapso / Meta.

​
7. Suprimieron el acceso de Nubea como socio en Meta

Si alguien de tu equipo entró a Meta Business y por error sacó a Kapso (el BSP que usa Nubea) de los Socios de tu cuenta de WhatsApp, los envíos cortan inmediatamente. Cómo verificarlo: Cómo arreglarlo: rehacé el flow de conexión desde Nubea (Configuración de WhatsApp → API Oficial (Meta)). Eso vuelve a agregar a Kapso como socio.

​
8. La salud del número (Kapso / Meta) está deteriorada

Meta lleva un quality rating por número: si bajás a Medium o Low, te limita los envíos y, en casos extremos, pausa el número. Cómo verificarlo:
  • Meta Business Suite → WhatsApp Manager → tu número → Quality rating.
  • O en el panel de Nubea, sección Configuración de WhatsApp, mostramos el estado de salud (verde / amarillo / rojo).
Cómo arreglarlo:
  • Pausá campañas masivas y mensajes a contactos no opt-in unos días.
  • Mejorá los copys (menos promocional, más informativo).
  • Revisá mejores prácticas de WhatsApp.
  • La salud se recupera sola en 5-7 días si bajás el volumen y mejorás la interacción.

​
9. El popup de conexión de Meta no carga

Cuando tocás Activar plan en API Oficial, se abre un popup de Facebook. Si no carga, casi siempre es por un bloqueador de anuncios o un bloqueador de popups. Cómo verificarlo: mirá si tenés uBlock, AdBlock o el bloqueador nativo del navegador activo en nubea.com.ar. Cómo arreglarlo:
  • Desactivá los bloqueadores para nubea.com.ar.
  • Probá en modo incógnito (que no carga extensiones por default).
  • Si seguís sin poder, mirá la guía detallada de errores al conectar WhatsApp.
Si seguís con el problema, escribinos por WhatsApp al asistente y te ayudamos a diagnosticarlo.