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

# Plantillas de WhatsApp: qué son y cómo funcionan

> Qué es una plantilla, por qué Meta las exige, cómo se crean y aprueban, y por qué a veces una automatización deja de enviar hasta que tengas una.

Si conectaste WhatsApp por **API Oficial** —el Número de Nubea, Coexistencia o
tu Número Dedicado— vas a necesitar **plantillas**. Es el requisito que más
frena a las tiendas al arrancar, y casi siempre es porque nadie explicó qué
son.

Esta guía es esa explicación.

<Note>
  **En el panel se llaman "Mensajes de WhatsApp".** Meta las llama *plantillas*
  o *templates*, y nosotros también en esta documentación. Es lo mismo: cuando
  leas "creá una plantilla", el botón que buscás dice **Crear mensaje**.
</Note>

***

## Qué es una plantilla

Una plantilla es **un mensaje que Meta revisa y aprueba antes de que puedas
enviarlo**.

La regla de fondo es de Meta, no de Nubea: por la API Oficial **no podés
escribirle texto libre a alguien que no te escribió primero**. Si pasaron más
de 24 horas desde el último mensaje del cliente —o si nunca te escribió, que es
el caso de un carrito abandonado— el único mensaje que sale es una plantilla
aprobada.

Por eso existen. No son una función de Nubea: son la única forma de iniciar una
conversación.

<Warning>
  Mientras una automatización no tenga una plantilla **aprobada** asignada, no
  envía nada. No es una caída ni un error: está esperando.
</Warning>

### Cuándo NO necesitás plantillas

Si conectaste por **código QR**, no. Esa conexión manda texto libre y escribís
el mensaje directamente en la automatización.

La contra es el resto: tope de 25 mensajes por día, sin campañas masivas, la
conexión depende de tu celular, y no tenés seguimiento de entregado ni leído.

<Note>
  Si venías de QR y cambiaste a una conexión oficial, tus automatizaciones van a
  mostrar **Requiere actualización**. No se desconfiguró nada: los textos libres
  que tenías dejaron de ser válidos y hay que reemplazarlos por plantillas. El
  paso a paso está en
  [errores de envío](/guias/troubleshooting/errores-mensajes-whatsapp).
</Note>

***

## El ciclo de vida de una plantilla

<Steps>
  <Step title="La creás">
    Panel → click en el nombre de tu marca (abajo a la izquierda) →
    **Configuración de WhatsApp** → **Mensajes de WhatsApp** → **Crear
    mensaje**. Escribís el texto, elegís la categoría y las variables.
  </Step>

  <Step title="Queda Pendiente de aprobación">
    Al guardar, la mandamos a Meta y queda en **Pendiente**. Meta la revisa: en
    general tarda entre 1 y 24 horas, y la primera suele ser la más lenta.
  </Step>

  <Step title="Meta la aprueba o la rechaza">
    Cuando pasa a **Aprobada**, ya se puede usar. Te avisamos por email — no
    hace falta que estés mirando la pantalla. Si la rechaza, vas a ver el motivo
    en rojo debajo del nombre.
  </Step>

  <Step title="La asignás a la automatización">
    Este paso falta seguido. Entrá a la automatización → pestaña **Mensaje** →
    seleccioná la plantilla aprobada → guardá. Recién ahí empieza a enviar.
  </Step>
</Steps>

<Tip>
  Antes de dejarla corriendo, usá **Probar mensaje** en la fila de la plantilla.
  Te la manda al número que le indiques para que veas exactamente cómo llega,
  con las variables completadas.
</Tip>

### Los cuatro estados

| Estado                      | Qué significa                                                | Qué hacer                            |
| --------------------------- | ------------------------------------------------------------ | ------------------------------------ |
| **Aprobada**                | Meta la aceptó, ya se puede usar                             | Asignala a una automatización        |
| **Pendiente de aprobación** | Meta la está revisando                                       | Esperar (1-24 h). Nada más           |
| **Rechazada**               | Meta la rechazó, con motivo                                  | Corregir el texto y volver a crearla |
| **Deshabilitada**           | Meta la dio de baja, casi siempre por mala calidad acumulada | Crear una nueva con otro enfoque     |

***

## Marketing o Utilidad: la categoría importa

Al crear la plantilla elegís una categoría, y la decisión tiene consecuencias
reales.

<CardGroup cols={2}>
  <Card title="Marketing" icon="bullhorn">
    Promocional: carrito abandonado, promos, lanzamientos, reactivación.

    Meta lo cobra más caro, lo topea por persona y por día, y es lo primero que
    corta si algo anda mal en tu cuenta.
  </Card>

  <Card title="Utilidad" icon="receipt">
    Informativo sobre una operación existente: pago pendiente, pedido enviado,
    pedido listo para retirar.

    Más barato y con menos restricciones, porque el cliente lo espera.
  </Card>
</CardGroup>

Esto explica algo que confunde muchísimo: **que una automatización falle y otra
no**. Si el carrito abandonado tira error y "pedido listo para retirar" sale
perfecto, no es que una esté rota. Son categorías distintas y Meta corta
Marketing primero.

<Warning>
  No clasifiques como **Utilidad** un mensaje que es promocional para que salga
  más barato. Meta recategoriza por su cuenta y las reclasificaciones repetidas
  le bajan la calidad a tu número.
</Warning>

***

## Variables: el texto que cambia en cada envío

Las variables son los huecos que se completan al momento de enviar: el nombre
del cliente, el link del carrito, el cupón.

En el editor las vas a ver como `{{1}}`, `{{2}}` y así. Al lado de cada una
elegís qué dato la completa.

**Dos reglas que evitan casi todos los rechazos:**

* Que la plantilla **no empiece ni termine** con una variable. Meta rechaza eso.
* Que ninguna variable pueda quedar vacía. Si un cliente no tiene nombre
  cargado, el envío falla con *"Faltan parámetros del template"*. Si un dato no
  siempre existe, no lo uses.

<Tip>
  En lugar de `Hola {{1}}, dejaste algo en el carrito`, escribí
  `Hola! {{1}}, dejaste algo en el carrito`. Cambia poco y saca de encima el
  rechazo más común.
</Tip>

***

## ¿Las creo en Nubea o en Meta?

**En Nubea.** Es la pregunta más frecuente y la respuesta corta es esa.

Cuando creás un mensaje desde el panel, la plantilla se crea a través de nuestra
conexión de socio con Meta. No necesitás permisos especiales en tu cuenta.

<Note>
  Puede pasar que en `business.facebook.com` el botón de crear plantillas te
  aparezca **gris o deshabilitado**. Eso no te bloquea: son dos caminos
  distintos, y el de Nubea sigue funcionando. Ese botón gris suele aparecer
  cuando tu cuenta de WhatsApp Business fue creada desde la app del celular, un
  tipo de cuenta que Meta no deja administrar plantillas.
</Note>

### Qué hace "Sincronizar"

El botón **Sincronizar** trae a Nubea las plantillas que ya existen en la cuenta
de WhatsApp **que tenés conectada ahora**. Sirve si ya venías trabajando con esa
cuenta y no querés recrear todo.

<Warning>
  **No trae plantillas de otra cuenta.** Si tenés más de una cuenta de WhatsApp
  Business en tu portfolio de Meta y la plantilla quedó en la que *no* está
  conectada, Sincronizar no la va a encontrar. No hay forma de mover una
  plantilla de una cuenta a otra: hay que recrearla, y son dos minutos.
</Warning>

***

## Las plantillas están atadas a la conexión

Una plantilla no es tuya en abstracto: pertenece a la cuenta de WhatsApp con la
que se creó. Si cambiás de número o de tipo de conexión, **las plantillas
viejas dejan de servir**.

Cuando eso pasa vas a ver errores como *"El mensaje pertenece a otra conexión de
WhatsApp"* o *"El mensaje ya no está disponible en tu cuenta actual"*. La
solución siempre es la misma: crear la plantilla en la cuenta nueva y volver a
asignarla en la automatización.

<Note>
  Si eliminás una plantilla desde Nubea, **también se elimina de Meta**. No se
  puede deshacer.
</Note>

***

## Cómo escribir una que pase a la primera

Meta rechaza por el contenido, no por el formato. Lo que más se rechaza:

* **Exceso de mayúsculas y signos** — `¡¡¡OFERTA ÚNICA!!!` no pasa.
* **Promesas o urgencia agresiva** — "última oportunidad", "solo por hoy"
  repetido.
* **Links sin contexto**, sobre todo acortadores.
* **Pedir datos sensibles** — tarjeta, documento, contraseñas.
* **Empezar o terminar con una variable** (la regla de arriba).

Lo que sí funciona: identificarte, decir por qué le escribís y ser breve.

> Hola `{{1}}`! Vimos que dejaste unos productos en tu carrito en `{{2}}`.
> Si querés terminar la compra, te dejamos el link acá abajo. Cualquier duda,
> respondenos por acá.

<Note>
  Si te la rechazan, el motivo aparece en rojo debajo del nombre de la
  plantilla. Corregí eso puntual y volvé a crearla — no hace falta empezar todo
  de nuevo.
</Note>

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="Está aprobada en Meta pero en Nubea figura Pendiente">
    Leemos el estado de Meta cada tanto, así que puede haber unos minutos de
    desfasaje. Tocá **Sincronizar** para forzar la lectura. Si después de eso
    sigue en Pendiente por más de 24 h, escribinos.
  </Accordion>

  <Accordion title="La plantilla está aprobada y la automatización no envía">
    Casi seguro falta el último paso: **asignarla**. Entrá a la automatización →
    pestaña **Mensaje** → seleccioná la plantilla → guardá. Crear la plantilla y
    usarla son dos acciones distintas.
  </Accordion>

  <Accordion title="Uso el Número de Nubea, ¿igual necesito plantillas?">
    Sí. El Número de Nubea es la API Oficial de Meta con un número nuestro, así
    que aplica la misma regla. Lo que te ahorrás es el trámite de alta y la
    facturación con Meta, no las plantillas.
  </Accordion>

  <Accordion title="¿Cuántas plantillas puedo tener?">
    Las que necesites. En la práctica alcanza con una por automatización que
    uses, más las que armes para campañas puntuales.
  </Accordion>

  <Accordion title="¿Puedo editar una plantilla aprobada?">
    No conviene: cualquier cambio de contenido vuelve a pasar por revisión de
    Meta. Si necesitás un texto distinto, creá una nueva y cambiá cuál usa la
    automatización. Así la vieja sigue enviando mientras la nueva espera
    aprobación.
  </Accordion>

  <Accordion title="El mensaje llega con una variable sin reemplazar">
    Quedó una variable sin dato asignado. Editá la plantilla y revisá que cada
    variable tenga su valor, o sacá la que no uses.
  </Accordion>
</AccordionGroup>

***

## Seguí por acá

<CardGroup cols={2}>
  <Card title="Errores de envío" icon="triangle-exclamation" href="/guias/troubleshooting/errores-mensajes-whatsapp">
    El diccionario completo: buscá el texto exacto del error que te aparece.
  </Card>

  <Card title="Conectar la API Oficial" icon="link" href="/guias/conectar-api-oficial">
    El paso previo: dar de alta tu número con Meta.
  </Card>

  <Card title="Configurar automatizaciones" icon="bolt" href="/guias/configurar-automatizaciones">
    Dónde se asigna la plantilla a cada automatización.
  </Card>

  <Card title="Mejores prácticas de WhatsApp" icon="whatsapp" href="/guias/mejores-practicas-whatsapp">
    Cuidar la calidad del número para que no te limiten.
  </Card>
</CardGroup>
