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.

Esta guía te lleva pantalla por pantalla por todo el flow de conexión a la API Oficial de Meta desde Nubea. Si todavía no decidiste qué método de conexión te conviene, mirá primero Configurar WhatsApp — esta página asume que ya elegiste API Oficial.
El proceso atraviesa 3 plataformas: Nubea → Kapso (nuestro integrador oficial de Meta) → Facebook Business. Es normal que cambies de pestaña varias veces. El flow completo lleva 5-10 minutos.

Antes de empezar — checklist

Tené todo a mano antes de arrancar

  • Cuenta de Facebook Business activa (si no tenés, Meta te la crea en el flow).
  • Tu número de WhatsApp Business. Si está en WhatsApp normal, migrá primero a la app WhatsApp Business (no perdés el chat).
  • Tarjeta de crédito a nombre de la empresa — Meta cobra los mensajes directo a esa tarjeta.
  • Plan Pro de Nubea activo.
  • Pop-ups habilitados y bloqueador de anuncios desactivado para nubea.com.ar y facebook.com.

Cuánto cuesta la API Oficial

Con la API Oficial, cada mensaje tiene dos componentes de costo:
1. Tarifa de Meta — Meta cobra todos los mensajes, directo a tu tarjeta empresarial, al cambio oficial USD→ARS del día del envío:
  • Marketing — USD 0,06 por mensaje: campañas, carrito abandonado y todo mensaje que busca generar venta.
  • Utilidad — USD 0,02 por mensaje: pedido enviado, pago pendiente, reseñas, pedido listo para retirar.
2. Fee de procesamiento de Nubea — $16 ARS por mensaje, solo a partir del mensaje 251 de cada mes. Los primeros 250 mensajes mensuales por API Oficial (sumando campañas, automatizaciones y reseñas) no tienen fee de Nubea; el contador se reinicia cada mes calendario. Se factura junto a la suscripción.

Fase 1 — Iniciar el flow desde Nubea

1

Abrí Configuración de WhatsApp

En el panel de Nubea, hacé click en el nombre de tu marca abajo a la izquierda del sidebar (donde aparece el avatar y email de tu cuenta) y seleccioná Configuración de WhatsApp del menú que se despliega.
2

Tocá Conectar con API Oficial

En la sección de métodos de conexión, hacé click en el botón verde “Conectar con API Oficial” (segunda opción, badge “Recomendada”).
3

Generá el link de configuración

Hacé click en el botón verde “Generar link de configuración”. Se abre una nueva pestaña con la plataforma de Kapso.
Si no se abre la nueva pestaña, revisá que tu navegador no tenga el bloqueador de pop-ups activo para Nubea. En Chrome aparece un ícono 🚫 a la derecha de la barra de URL — hacé click ahí y permití pop-ups.

Fase 2 — Configurar en Kapso

1

Elegí 'Conectar la app de WhatsApp Business'

En la pantalla de Kapso vas a ver dos opciones. Seleccioná la primera caja: “Conectar la app de WhatsApp Business”.
2

Tocá 'Conectar tu app'

En la siguiente pantalla (“Completar configuración”), hacé click en el botón azul “Conectar tu app”. Se abre una ventana emergente de Facebook con el Embedded Signup de Meta.
No cierres esta ventana emergente hasta que termines el proceso en Meta. Si la cerrás antes, tenés que arrancar de cero.

Fase 3 — Completar el flow en Meta (Facebook Business)

1

Iniciá sesión y aceptá permisos

Hacé click en “Continuar” para permitir que Kapso se conecte con tu cuenta de Meta. Vas a iniciar sesión con tu cuenta de Facebook Business si no estás logueado.
2

Seleccioná tu Portfolio comercial

Desplegá el menú “Selecciona los activos comerciales” y elegí tu Portfolio comercial (también llamado Business Manager). Tocá Siguiente.
El Portfolio comercial es la cuenta paraguas donde Meta agrupa todos tus assets: Páginas de Facebook, Instagram, WhatsApp, cuentas de ads. No es tu Página de Facebook. Si todavía no tenés Portfolio, el flow te lo crea — te pide nombre comercial y email de admin.
3

Seleccioná tu cuenta de WhatsApp Business

Si ya tenés una WhatsApp Business Account (WABA), elegila. Si no, creá una nueva en el momento. Tocá Siguiente.
4

Cargá tu número de teléfono

  • Seleccioná el país (ej: Argentina +54).
  • Ingresá el número de teléfono de tu WhatsApp Business.
  • Tocá Siguiente.
🇦🇷 Argentina: ingresá el número sin el “9”. El flow lo agrega solo (los celulares argentinos en formato internacional se registran como +54 9 [area] [número]).
Si te tira un error tipo HTTP 500 después de cargar el número, mirá Errores comunes al conectar WhatsApp — casi siempre es porque el número está registrado en otra cuenta o tiene la verificación en dos pasos activa.
5

Seleccioná tu zona horaria

Elegí “(GMT-03:00) America/Argentina/Buenos_Aires” (o la zona que corresponda a tu tienda). Tocá Siguiente.
6

Confirmá los permisos finales

Revisá que los permisos de administración para Kapso estén todos activos (incluye “manage_phone_numbers”, “messaging”, etc.) y hacé click en “Confirmar”.
7

Esperá el mensaje de éxito y tocá Finalizar

Meta tarda unos segundos en validar. Cuando aparece el mensaje de éxito, hacé click en “Finalizar” para cerrar la ventana emergente.

Fase 4 — Volver a Nubea y revisar el estado

1

Esperá la redirección automática

La pestaña de Kapso te muestra “Conectando…” mientras sincroniza con Meta. Una vez listo, te redirige automáticamente a Nubea.
No tenés que cerrar la pestaña de Kapso a mano. Si no se cierra en 30 segundos, refrescá la pestaña de Nubea — el estado ya quedó guardado.
2

Verificá el cartel verde

En el panel de Nubea vas a ver el cartel verde de “Conectado - API Oficial”. Eso significa que la integración con Meta quedó establecida.
3

Revisá los avisos en 'Estado del número'

Es normal que aparezcan uno o dos avisos justo después de conectar. No son errores — son pasos finales que Meta requiere para activar el envío:
AvisoQué significaCuándo se resuelve
🟡 Falta método de pagoTenés que cargar una tarjeta de crédito en Meta Business Manager para que Meta pueda cobrar los mensajes.Apenas cargues la tarjeta en business.facebook.com → WhatsApp Business → Pagos.
🟡 Nombre en revisiónMeta está validando el Display Name de tu marca para que aparezca en los chats de tus clientes.Hasta 24 horas. Te llega un mail cuando se aprueba o rechaza.

Display Name — qué validar

El Display Name es el nombre que tus clientes ven en su WhatsApp cuando les llega un mensaje tuyo (en vez de tu número de teléfono). Lo configurás durante el flow de Kapso. Reglas que pone Meta:
  • Tiene que coincidir con el nombre real de tu marca.
  • Sin emojis, sin URLs, sin caracteres especiales.
  • No vale poner “WhatsApp Oficial” o “Atención al cliente” genéricos.
  • Sin solo mayúsculas con signos de exclamación (ej: “Mi Marca” se aprueba, “MEGA OFERTAS!!!” no).
Aprobación:
  • Meta revisa en hasta 24 horas. Mientras tanto no podés enviar mensajes.
  • Si te lo rechazan, te llega un mail con el motivo. Editás el nombre desde Meta Business Manager y lo enviás de nuevo.
Usá exactamente el mismo nombre que aparece en tu Tiendanube y en tu Instagram comercial. Así nadie se confunde cuando recibe un mensaje.

¿Algo falló durante el proceso?

Errores al conectar

Soluciones paso a paso a los errores más comunes (HTTP 500, número en uso, etc.).

Volver al overview

Comparativa de los 3 métodos de conexión + pricing por mensaje.

Próximos pasos

Una vez que el Display Name esté aprobado y la tarjeta cargada, tu API Oficial está lista para mandar mensajes. El próximo paso es activar las automatizaciones:

Configurar automatizaciones

Carritos abandonados, pago pendiente, pedido enviado.

Mejores prácticas

Cómo escribir mensajes que no caen en spam y que convierten.