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

# Errores al conectar WhatsApp

> Soluciones paso a paso para los errores más comunes que aparecen al vincular tu WhatsApp con Nubea.

Si te aparece un error mientras estás conectando tu WhatsApp en Nubea,
encontrá tu caso abajo y seguí los pasos. La mayoría se resuelve en 5-10 minutos.

<Note>
  Si el error que ves no figura acá, mandanos una **captura del error completo** y el **Session ID** (suele aparecer abajo del modal) a [ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar).
</Note>

***

## No se vincula el QR de WhatsApp

<div
  style={{
maxWidth: 520,
background: '#fff',
border: '1px solid #e5e7eb',
borderRadius: 12,
padding: 20,
fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
}}
>
  <div
    style={{
  fontSize: 13,
  color: '#6b7280',
  marginBottom: 12,
  lineHeight: 1.5
}}
  >
    ...meses del historial de chat y otra información relevante.
  </div>

  <div
    style={{
  border: '1px solid #fecaca',
  borderLeft: '4px solid #dc2626',
  borderRadius: 8,
  padding: 14,
  background: '#fff',
  marginBottom: 14
}}
  >
    <div style={{ display: 'flex', gap: 10, alignItems: 'flex-start' }}>
      <span
        style={{
      color: '#dc2626',
      fontSize: 16,
      lineHeight: 1,
      marginTop: 2
    }}
      >
        ⊘
      </span>

      <div
        style={{
      fontSize: 12,
      color: '#7f1d1d',
      fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
      lineHeight: 1.5
    }}
      >
        Error code: Optional(16), Error Description: Error Domain=wa.md.pair Code=16 "(null)"

        <br />

        (#4563004:019e098c-15d1-7640-9170-f1a3567b0a13)
      </div>
    </div>
  </div>

  <div
    style={{
  fontSize: 12,
  color: '#374151',
  display: 'flex',
  alignItems: 'center',
  gap: 8,
  marginBottom: 8
}}
  >
    <span style={{ fontWeight: 600 }}>¿Te resultó útil?</span>
    <span style={{ fontSize: 14 }}>👍</span>
    <span style={{ fontSize: 14 }}>👎</span>
  </div>

  <div
    style={{
  fontSize: 12,
  color: '#2563eb',
  textDecoration: 'underline'
}}
  >
    Reportar error a Kapso
  </div>
</div>

*El mensaje incluye texto como `wa.md.pair` o `Code=16` y aparece al escanear el QR o ingresar el código de 8 dígitos.*

**Por qué pasa:** la app de WhatsApp en el celular está desactualizada y no puede completar la vinculación. Meta actualizó el sistema de dispositivos vinculados (Multi-Device) y las versiones viejas dejan de funcionar.

**Qué hacer (5 minutos):**

<Steps>
  <Step title="Actualizá WhatsApp en el celular">
    Abrí la **Play Store** (Android) o **App Store** (iPhone), buscá **WhatsApp** (y también **WhatsApp Business** si usás ambas) y tocá **Actualizar**. Si dice **Abrir**, ya estás en la última versión.
  </Step>

  <Step title="Reiniciá el celular">
    Apagalo y prendelo de nuevo. Limpia conexiones viejas trabadas.
  </Step>

  <Step title="Cerrá sesiones viejas">
    WhatsApp Business → **Configuración** → **Dispositivos vinculados**. Si ves dispositivos que no usás, tocalos y **Cerrar sesión**.
  </Step>

  <Step title="Verificá la hora automática">
    **Configuración** → **Fecha y hora** → activá **Fecha y hora automáticas**. Si está desincronizada, la vinculación falla.
  </Step>

  <Step title="Volvé a conectar en Nubea">
    Generá un código nuevo y escanealo o ingresalo rápido — expira en \~60 segundos.
  </Step>
</Steps>

**Si sigue sin funcionar**: probá desde otra red (sin VPN), desde otro celular si tenés WhatsApp en más de uno, o mandanos la captura a [ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar).

***

## Falla al ingresar el número en API Oficial

<div
  style={{
maxWidth: 520,
background: '#fff',
border: '1px solid #e5e7eb',
borderRadius: 12,
padding: 20,
fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
}}
>
  <div style={{ display: 'flex', gap: 16 }}>
    <div
      style={{
    display: 'flex',
    flexDirection: 'column',
    alignItems: 'center',
    gap: 12,
    paddingTop: 4
  }}
    >
      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#16a34a',
      color: '#fff',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      fontSize: 12,
      fontWeight: 700
    }}
      >
        ✓
      </div>

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#16a34a',
      color: '#fff',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      fontSize: 12,
      fontWeight: 700
    }}
      >
        ✓
      </div>

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#dc2626',
      color: '#fff',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      fontSize: 12,
      fontWeight: 700
    }}
      >
        !
      </div>

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#fff',
      border: '2px solid #d1d5db'
    }}
      />

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#fff',
      border: '2px solid #d1d5db'
    }}
      />
    </div>

    <div style={{ flex: 1, minWidth: 0 }}>
      <div
        style={{
      fontSize: 15,
      fontWeight: 700,
      color: '#111827',
      marginBottom: 4
    }}
      >
        Ingresa tu número de teléfono de WhatsApp Business
      </div>

      <div style={{ fontSize: 13, color: '#6b7280', marginBottom: 16 }}>
        Selecciona un país e ingresa tu número de teléfono
      </div>

      <div style={{ fontSize: 13, fontWeight: 600, color: '#111827', marginBottom: 8 }}>
        Número de teléfono
      </div>

      <div style={{ display: 'flex', gap: 8, marginBottom: 8 }}>
        <div
          style={{
        display: 'flex',
        alignItems: 'center',
        gap: 6,
        padding: '8px 12px',
        border: '1px solid #d1d5db',
        borderRadius: 6,
        fontSize: 13,
        color: '#374151',
        minWidth: 90
      }}
        >
          🇦🇷 +54 ▾
        </div>

        <div
          style={{
        flex: 1,
        display: 'flex',
        alignItems: 'center',
        justifyContent: 'space-between',
        padding: '8px 12px',
        border: '1px solid #dc2626',
        borderRadius: 6,
        fontSize: 13,
        color: '#9ca3af',
        background: '#fff'
      }}
        >
          <span>Tu número de WhatsApp Business</span>
          <span style={{ color: '#dc2626' }}>⊘</span>
        </div>
      </div>

      <div style={{ fontSize: 11, color: '#6b7280', marginBottom: 14 }}>
        Si no agregaste el número de la app de WhatsApp Business a tu portfolio comercial, deberás verificarlo para continuar.
      </div>

      <div
        style={{
      border: '1px solid #fecaca',
      borderRadius: 8,
      padding: 12,
      background: '#fff',
      fontSize: 12,
      color: '#7f1d1d',
      fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace'
    }}
      >
        <div style={{ display: 'flex', gap: 8, alignItems: 'flex-start' }}>
          <span style={{ color: '#dc2626' }}>⊘</span>

          <div>
            Network request encountered error HTTP 500 HTTP\_SERVER\_ERROR: \<?xml version="1.0"?> \<!DOCTYPE html> \<html lang="en" id="facebook">...
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

*Aparece `Network request encountered error HTTP 500` con una pantalla que muestra el logo de Facebook.*

**Por qué pasa:** el número que estás intentando conectar **ya está
registrado en otra cuenta de WhatsApp Business API** en el sistema de Meta,
o tiene la **verificación en dos pasos** activa — y eso impide que Nubea lo pueda dar de alta.

**Qué hacer:**

<Steps>
  <Step title="Desactivá la verificación en dos pasos">
    1. Abrí **WhatsApp Business** en el celular del número que querés
       conectar.
    2. **Configuración** → **Cuenta** → **Verificación en dos pasos**.
    3. Tocá **Desactivar** e ingresá el PIN.

    <Tip>
      Una vez conectado a Nubea, podés volver a activarla.
    </Tip>
  </Step>

  <Step title="Verificá si el número ya está en otra plataforma">
    Hacete estas preguntas:

    * ¿Antes usaste este número con otra plataforma de WhatsApp API
      (360dialog, Twilio, Wati, MessageBird, Gupshup, Kapso, otra agencia o proveedor)?
    * ¿Una agencia de marketing te lo configuró alguna vez?
    * ¿Tuviste antes una cuenta de Meta Business donde se conectó este
      número?

    Si la respuesta es **SÍ** a alguna, hay que liberarlo de esa cuenta antes de usarlo en Nubea (paso siguiente). Si es **NO**, saltá a "Verificá tu Portfolio Comercial".
  </Step>

  <Step title="Liberá el número de la cuenta vieja">
    **Si tenés acceso a la cuenta vieja:**

    1. Entrá a [business.facebook.com](https://business.facebook.com) con
       esa cuenta.
    2. **Configuración del negocio** → **Cuentas** → **Cuentas de
       WhatsApp**.
    3. Seleccioná la cuenta donde está el número.
    4. **Números de teléfono** → seleccioná tu número → **Eliminar
       número** → confirmá.

    **Si NO tenés acceso a la cuenta vieja:**

    1. Entrá a [business.facebook.com](https://business.facebook.com) con
       tu cuenta nueva.
    2. **Ayuda** → **Contactar soporte**.
    3. Explicá que necesitás **liberar tu número de WhatsApp** que está
       registrado en otra cuenta a la que ya no tenés acceso.
    4. Tené a mano: factura de la línea a tu nombre o algún comprobante de
       que el número es tuyo.

    <Warning>
      Meta tarda entre **24h y 7 días** en liberar un número por soporte. No es instantáneo.
    </Warning>
  </Step>

  <Step title="Verificá tu Portfolio Comercial">
    1. Entrá a [business.facebook.com](https://business.facebook.com).
    2. **Configuración del negocio** → **Información del negocio**.
    3. Confirmá que tu negocio diga **Verificado** en verde.
    4. Si no está verificado, completá el proceso (te pide documentación
       del negocio).
  </Step>

  <Step title="Esperá 30 minutos y reintentá">
    Después de cualquier cambio en Meta, los servers tardan en sincronizar. Esperá **30 minutos** y reintentá la conexión en Nubea.

    **Tips para reintentar:**

    * Usá una **ventana de incógnito** del navegador.
    * Cerrá sesión de Facebook y volvé a entrar.
    * Probá distintos formatos del número:
      * `11 3937-7441`
      * `1139377441`
      * Con y sin el `9` después del `+54` (los celulares argentinos en
        formato internacional necesitan el 9: `+54 9 11 3937-7441`).
  </Step>
</Steps>

**Si sigue sin funcionar**, mandanos a [ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar):

* Captura de la pantalla con el error completo.
* El **Session ID** que aparece abajo del modal (ej:
  `019dfd4e-2cc6-748f-bc65-...`).
* Si antes usaste el número con otra plataforma, decinos cuál.

## Con el Session ID podemos rastrear el problema directamente con soporte de Meta.

## La cuenta ya está compartida con otro socio

<div
  style={{
maxWidth: 520,
background: '#fff',
border: '1px solid #e5e7eb',
borderRadius: 12,
padding: 20,
fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif'
}}
>
  <div style={{ display: 'flex', gap: 16 }}>
    <div
      style={{
    display: 'flex',
    flexDirection: 'column',
    alignItems: 'center',
    gap: 12,
    paddingTop: 4
  }}
    >
      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#16a34a',
      color: '#fff',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      fontSize: 12,
      fontWeight: 700
    }}
      >
        ✓
      </div>

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#dc2626',
      color: '#fff',
      display: 'flex',
      alignItems: 'center',
      justifyContent: 'center',
      fontSize: 12,
      fontWeight: 700
    }}
      >
        !
      </div>

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#fff',
      border: '2px solid #d1d5db'
    }}
      />

      <div
        style={{
      width: 22,
      height: 22,
      borderRadius: '50%',
      background: '#fff',
      border: '2px solid #d1d5db'
    }}
      />
    </div>

    <div style={{ flex: 1, minWidth: 0 }}>
      <div style={{ fontSize: 13, fontWeight: 600, color: '#111827', marginBottom: 8 }}>
        Número de teléfono
      </div>

      <div style={{ display: 'flex', gap: 8, marginBottom: 14 }}>
        <div
          style={{
        display: 'flex',
        alignItems: 'center',
        gap: 6,
        padding: '8px 12px',
        border: '1px solid #d1d5db',
        borderRadius: 6,
        fontSize: 13,
        color: '#374151',
        minWidth: 90
      }}
        >
          🇦🇷 +54 ▾
        </div>

        <div
          style={{
        flex: 1,
        display: 'flex',
        alignItems: 'center',
        justifyContent: 'space-between',
        padding: '8px 12px',
        border: '1px solid #dc2626',
        borderRadius: 6,
        fontSize: 13,
        color: '#9ca3af',
        background: '#fff'
      }}
        >
          <span>Tu número de WhatsApp Business</span>
          <span style={{ color: '#dc2626' }}>⊘</span>
        </div>
      </div>

      <div
        style={{
      border: '1px solid #fecaca',
      borderLeft: '4px solid #dc2626',
      borderRadius: 8,
      padding: 14,
      background: '#fff',
      marginBottom: 14
    }}
      >
        <div style={{ display: 'flex', gap: 10, alignItems: 'flex-start' }}>
          <span
            style={{
          color: '#dc2626',
          fontSize: 16,
          lineHeight: 1,
          marginTop: 2
        }}
          >
            ⊘
          </span>

          <div style={{ fontSize: 12, color: '#7f1d1d', lineHeight: 1.5 }}>
            Esta cuenta ya se comparte con otro socio. Puedes dejar de compartir esta cuenta con tu socio o crear una cuenta de WhatsApp Business
            nueva. <span style={{ color: '#2563eb', textDecoration: 'underline' }}>Información sobre las cuentas compartidas</span>

            <div style={{ marginTop: 6, fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace', fontSize: 11 }}>
              (#XXXXXXX:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)
            </div>
          </div>
        </div>
      </div>

      <div
        style={{
      fontSize: 12,
      color: '#374151',
      display: 'flex',
      alignItems: 'center',
      gap: 8,
      marginBottom: 8
    }}
      >
        <span style={{ fontWeight: 600 }}>¿Te resultó útil?</span>
        <span style={{ fontSize: 14 }}>👍</span>
        <span style={{ fontSize: 14 }}>👎</span>
      </div>

      <div style={{ fontSize: 12, color: '#2563eb', textDecoration: 'underline' }}>
        Reportar error a Kapso
      </div>
    </div>
  </div>
</div>

*Aparece `Esta cuenta ya se comparte con otro socio` después de ingresar el número.*

**Por qué pasa:** la **WhatsApp Business Account (WABA)** donde estás intentando dar de alta este número **ya está compartida con otra empresa o proveedor** en Meta (otra agencia, otro BSP, una app vieja). Meta no permite agregar un nuevo socio hasta que liberes el acceso del anterior — o hasta que crees una WABA nueva desde cero.

**Qué revisar primero (checklist rápido):**

<Steps>
  <Step title="Actualizá WhatsApp Business en el celular">
    Abrí la **Play Store** (Android) o **App Store** (iPhone), buscá **WhatsApp** (y también **WhatsApp Business** si usás ambas) y tocá **Actualizar**. Si dice **Abrir**, ya estás en la última versión.
  </Step>

  <Step title="Verificá que tu Portfolio Comercial esté verificado">
    Entrá a [business.facebook.com](https://business.facebook.com) → **Configuración del negocio** → **Información del negocio**. Confirmá que diga **Verificado** en verde. Si no, completá el proceso de verificación (te pide documentación del negocio).
  </Step>

  <Step title="Desactivá la verificación en dos pasos">
    1. Abrí **WhatsApp Business** en el celular del número que querés
       conectar.
    2. **Configuración** → **Cuenta** → **Verificación en dos pasos**.
    3. Tocá **Desactivar** e ingresá el PIN.

    <Tip>
      Una vez conectado a Nubea, podés volver a activarla.
    </Tip>
  </Step>
</Steps>

### Si el checklist no alcanza — liberar el socio anterior

Si después de pasar el checklist el error sigue, significa que **otro socio (agencia, app o proveedor) sigue vinculado** a tu WABA. Liberalo así:

<Steps>
  <Step title="Entrá a la configuración de tu cuenta de WhatsApp en Meta">
    Andá a [business.facebook.com/latest/settings/whatsapp\_account](https://business.facebook.com/latest/settings/whatsapp_account) y buscá la **cuenta de WhatsApp** asociada a tu marca.
  </Step>

  <Step title="Abrí la pestaña Socios">
    Seleccioná la cuenta y andá a la pestaña **Socios**. Acá ves todos los socios (empresas, agencias, apps) que tienen acceso a tu WABA.
  </Step>

  <Step title="Suprimí los accesos viejos">
    Identificá los socios que ya no usás. Hacé click en **Administrar** junto a cada uno → se abre un modal → tocá **Suprimir accesos** → confirmá.

    <Warning>
      Asegurate de no suprimir un socio que todavía estés usando activamente (otra app de WhatsApp, otro CRM). Si dudás, preguntale a la persona o agencia que te lo configuró.
    </Warning>
  </Step>

  <Step title="Volvé a Nubea y reintentá la conexión">
    Esperá 5-10 minutos para que Meta sincronice y reintentá el flow desde Nubea. Si el error sigue, mandanos a [ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar) el ID que aparece en el modal (`#XXXXXXX:...`) y lo escalamos con soporte de Meta.
  </Step>
</Steps>

***

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Cómo conectar WhatsApp" icon="whatsapp" href="/guias/configurar-whatsapp">
    Si todavía no terminaste el setup, volvé a la guía oficial.
  </Card>

  <Card title="API Oficial paso a paso" icon="meta" href="/guias/conectar-api-oficial">
    Walkthrough detallado del flow Embedded Signup, pantalla por pantalla.
  </Card>
</CardGroup>