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

# WhatsApp no conecta o se desconecta solo

> Por qué tu WhatsApp se desconecta de Nubea — diferenciado por método de conexión (QR vs API Oficial / Kapso) — y cómo restaurarlo.

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.

<Note>
  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.
</Note>

***

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

<Warning>
  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.
</Warning>

***

# 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](https://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](/guias/ampliar-limite-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](mailto: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:**

* [business.facebook.com/latest/settings/whatsapp\_account](https://business.facebook.com/latest/settings/whatsapp_account)
  → seleccioná tu WABA → pestaña **Socios**.
* Tiene que figurar **Kapso** con permisos sobre tu cuenta.

**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](/guias/mejores-practicas-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](/guias/errores-conectar-whatsapp).

***

Si seguís con el problema, escribinos por WhatsApp al asistente y te
ayudamos a diagnosticarlo.