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

​
No se vincula el QR de WhatsApp

…meses del historial de chat y otra información relevante.
⊘
Error code: Optional(16), Error Description: Error Domain=wa.md.pair Code=16 “(null)”
(#4563004:019e098c-15d1-7640-9170-f1a3567b0a13)
¿Te resultó útil?👍👎
Reportar error a Kapso
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):
1

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

Reiniciá el celular

Apagalo y prendelo de nuevo. Limpia conexiones viejas trabadas.
3

Cerrá sesiones viejas

WhatsApp Business → Configuración → Dispositivos vinculados. Si ves dispositivos que no usás, tocalos y Cerrar sesión.
4

Verificá la hora automática

Configuración → Fecha y hora → activá Fecha y hora automáticas. Si está desincronizada, la vinculación falla.
5

Volvé a conectar en Nubea

Generá un código nuevo y escanealo o ingresalo rápido — expira en ~60 segundos.
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.

​
Falla al ingresar el número en API Oficial

✓
✓
!
Ingresa tu número de teléfono de WhatsApp Business
Selecciona un país e ingresa tu número de teléfono
Número de teléfono
🇦🇷 +54 ▾
Tu número de WhatsApp Business⊘
Si no agregaste el número de la app de WhatsApp Business a tu portfolio comercial, deberás verificarlo para continuar.
⊘
Network request encountered error HTTP 500 HTTP_SERVER_ERROR: <?xml version=“1.0”?> <!DOCTYPE html> <html lang=“en” id=“facebook”>…
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:
1

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.
Una vez conectado a Nubea, podés volver a activarla.
2

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”.
3

Liberá el número de la cuenta vieja

Si tenés acceso a la cuenta vieja:
  1. Entrá a 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 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.
Meta tarda entre 24h y 7 días en liberar un número por soporte. No es instantáneo.
4

Verificá tu Portfolio Comercial

  1. Entrá a 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).
5

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).
Si sigue sin funcionar, mandanos a 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

✓
!
Número de teléfono
🇦🇷 +54 ▾
Tu número de WhatsApp Business⊘
⊘
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. Información sobre las cuentas compartidas
(#XXXXXXX:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)
¿Te resultó útil?👍👎
Reportar error a Kapso
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):
1

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

Verificá que tu Portfolio Comercial esté verificado

Entrá a 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).
3

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.
Una vez conectado a Nubea, podés volver a activarla.

​
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í:
1

Entrá a la configuración de tu cuenta de WhatsApp en Meta

Andá a business.facebook.com/latest/settings/whatsapp_account y buscá la cuenta de WhatsApp asociada a tu marca.
2

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

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á.
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ó.
4

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 el ID que aparece en el modal (#XXXXXXX:...) y lo escalamos con soporte de Meta.

​
Próximos pasos

Cómo conectar WhatsApp

Si todavía no terminaste el setup, volvé a la guía oficial.

API Oficial paso a paso

Walkthrough detallado del flow Embedded Signup, pantalla por pantalla.