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

# Conectar API Oficial de Meta paso a paso

> Walkthrough detallado del flow Embedded Signup de Meta — pantalla por pantalla, desde el panel de Nubea hasta el "Conectado" final.

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](/guias/configurar-whatsapp) — esta página asume que ya
elegiste API Oficial.

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

***

## Antes de empezar — checklist

<Card title="Tené todo a mano antes de arrancar" icon="clipboard-list">
  * 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.
</Card>

***

## Cuánto cuesta la API Oficial

Con la **API Oficial**, cada mensaje tiene **dos componentes de costo**:

<Info>
  **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.
</Info>

***

## Fase 1 — Iniciar el flow desde Nubea

<Steps>
  <Step title="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.
  </Step>

  <Step title="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").
  </Step>

  <Step title="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.

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

***

## Fase 2 — Configurar en Kapso

<Steps>
  <Step title="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"*.
  </Step>

  <Step title="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.

    <Warning>
      **No cierres esta ventana emergente** hasta que termines el proceso
      en Meta. Si la cerrás antes, tenés que arrancar de cero.
    </Warning>
  </Step>
</Steps>

***

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Seleccioná tu Portfolio comercial">
    Desplegá el menú **"Selecciona los activos comerciales"** y elegí tu
    **Portfolio comercial** (también llamado Business Manager). Tocá
    **Siguiente**.

    <Info>
      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.
    </Info>
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**.

    <Tip>
      🇦🇷 **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]`).
    </Tip>

    <Warning>
      Si te tira un error tipo `HTTP 500` después de cargar el número,
      mirá [Errores comunes al conectar
      WhatsApp](/guias/errores-conectar-whatsapp#error-2-http-500-al-ingresar-el-numero-api-oficial) —
      casi siempre es porque el número está registrado en otra cuenta o
      tiene la verificación en dos pasos activa.
    </Warning>
  </Step>

  <Step title="Seleccioná tu zona horaria">
    Elegí **"(GMT-03:00) America/Argentina/Buenos\_Aires"** (o la zona que
    corresponda a tu tienda). Tocá **Siguiente**.
  </Step>

  <Step title="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"**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Fase 4 — Volver a Nubea y revisar el estado

<Steps>
  <Step title="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.

    <Info>
      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.
    </Info>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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:

    | Aviso                       | Qué significa                                                                                             | Cuándo se resuelve                                                                |
    | --------------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
    | 🟡 **Falta método de pago** | Tené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ón**   | Meta 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.                     |
  </Step>
</Steps>

***

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

<Tip>
  Usá exactamente el mismo nombre que aparece en tu Tiendanube y en tu
  Instagram comercial. Así nadie se confunde cuando recibe un mensaje.
</Tip>

***

## ¿Algo falló durante el proceso?

<CardGroup cols={2}>
  <Card title="Errores al conectar" icon="circle-exclamation" href="/guias/errores-conectar-whatsapp">
    Soluciones paso a paso a los errores más comunes (HTTP 500, número en
    uso, etc.).
  </Card>

  <Card title="Volver al overview" icon="whatsapp" href="/guias/configurar-whatsapp">
    Comparativa de los 3 métodos de conexión + pricing por mensaje.
  </Card>
</CardGroup>

***

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

<CardGroup cols={2}>
  <Card title="Configurar automatizaciones" icon="bolt" href="/guias/configurar-automatizaciones">
    Carritos abandonados, pago pendiente, pedido enviado.
  </Card>

  <Card title="Mejores prácticas" icon="lightbulb" href="/guias/mejores-practicas-whatsapp">
    Cómo escribir mensajes que no caen en spam y que convierten.
  </Card>
</CardGroup>