> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Referencia de plantillas WhatsApp en Flowella
> Categorías de plantillas WhatsApp, formatos de encabezado, tipos de botón, sintaxis de variables, cupones y ubicación, y ciclo de vida del envío.
Esta página es una referencia para los componentes básicos de una plantilla de WhatsApp: categorías, encabezados, cuerpo, botones, variables, tipos de plantilla avanzados y el ciclo de vida del envío. Para los pasos detallados de creación y prueba de una plantilla, consulta [Plantillas](/app/templates). Para los límites de formato de los medios, consulta [Encabezados de medios](/app/media-in-template-headers).
## Categorías
Cada plantilla tiene exactamente una categoría, que se establece cuando la envías a Meta. La categoría determina el **precio** y **qué contenido está permitido**.
| Categoría | Úsala para | Notas |
| ----------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Marketing** | Promociones, ofertas, invitaciones a eventos, reactivación | El nivel más caro; sujeta a reglas de aceptación |
| **Utilidad** | Actualizaciones de pedidos, alertas de cuenta, recordatorios, seguimientos a un flujo iniciado por el usuario | Más barata que Marketing; el contenido debe estar relacionado con una transacción o solicitud específica |
| **Autenticación** | Contraseñas de un solo uso y códigos de verificación de cuenta | Formato estricto; no se permite contenido de marketing; el nivel más barato |
Si Meta considera que tu plantilla no coincide con la categoría que elegiste, será **rechazada** o **recategorizada** — algo común cuando se envía contenido de Marketing como Utilidad. La categoría también puede cambiar automáticamente conforme Meta observa patrones de uso, lo que a su vez cambia la tarifa que se te cobra.
## Formatos de encabezado
El encabezado de una plantilla es opcional. Cuando está presente, puede ser uno de:
* **TEXT** — cadena corta, puede incluir una variable.
* **IMAGE** — JPEG o PNG, máximo 5 MB. Consulta [Encabezados de medios](/app/media-in-template-headers).
* **VIDEO** — MP4 o 3GPP con H.264/AAC, máximo 16 MB.
* **DOCUMENT** — PDF (lo más fiable), formatos de Office o texto plano. Máximo 100 MB. El nombre del archivo es visible para el destinatario.
* **LOCATION** — latitud, longitud, nombre y dirección. Útil para visitas a tiendas o confirmaciones de entrega.
Los encabezados de medios pueden adjuntarse como un **identificador de medio** (subido una vez a Meta) o como una **URL HTTPS pública** que se obtiene en cada envío. Consulta [Encabezados de medios](/app/media-in-template-headers) para ver las ventajas e inconvenientes.
## Cuerpo y variables
El cuerpo es el texto principal del mensaje. Las variables usan **dobles llaves con un índice basado en 1**:
```text theme={null}
Hola {{1}}, tu pedido {{2}} se ha enviado. Síguelo aquí: {{3}}
```
Reglas:
* Los números deben ser secuenciales empezando por `{{1}}` — no puedes saltarte índices.
* Proporciona un valor de ejemplo para cada variable cuando envíes la plantilla. Meta usa los ejemplos para evaluarla.
* Mantén las variables con valores cortos y predecibles. Los bloques largos pegados son un motivo común de rechazo.
La misma sintaxis `{{n}}` se utiliza en **encabezados TEXT** y **botones URL** (ver más abajo).
### Formato en el cuerpo
WhatsApp admite un conjunto limitado de formato en línea en los cuerpos de las plantillas:
* **Negrita** con `*asteriscos*`
* **Cursiva** con `_guiones bajos_`
* **Tachado** con `~virgulillas~`
* **Monoespaciado** con triples comillas invertidas
Usa el formato con moderación. Las plantillas con mucho formato suelen rechazarse por parecer spam.
## Pie de página
Texto plano opcional que se muestra después del cuerpo. Sin variables ni formato.
## Botones
Una plantilla puede incluir hasta **10 botones en total**, agrupados como respuestas rápidas o llamadas a la acción. Las combinaciones que permite Meta han variado a lo largo de las versiones de la Cloud API; los patrones más fiables son:
| Tipo de botón | Lo que hace | Ejemplo | ¿Variable? |
| ---------------- | -------------------------------------------------------------- | ------------------------------- | ---------------------------------- |
| **QUICK\_REPLY** | Envía una respuesta de texto predefinida a tu empresa | `Sí, soy yo` | No |
| **URL** | Abre una página web | `https://acme.com/orders/{{1}}` | Una en la URL |
| **PHONE** | Llama a un número de teléfono | `+44 20 7946 0000` | No |
| **COPY\_CODE** | Copia un código al portapapeles | `SAVE20` | Una para el código |
| **FLOW** | Abre un WhatsApp Flow | (ID de Flow vinculado) | Variables a través del propio Flow |
| **CATALOG** | Abre tu catálogo de WhatsApp | (ID de catálogo vinculado) | No |
| **MPM** | Lanzador de mensaje multiproducto | (productos del catálogo) | No |
| **VOICE\_CALL** | Inicia una llamada de voz por WhatsApp (donde esté disponible) | (tu número de empresa) | No |
Los botones de respuesta rápida son útiles cuando quieres una respuesta estructurada (bueno para analítica). Los botones de URL y teléfono son útiles para dirigir a los destinatarios fuera de WhatsApp hacia tu stack. Los botones FLOW son la puerta de entrada a los Flows impulsados por formularios de HubSpot en los que Flowella está especializada.
## Tipos de plantilla especializados
Meta dispone de varios tipos de plantilla de marketing especializados que incorporan funcionalidad extra sobre la estructura base.
### Plantillas de carrusel
Una plantilla de carrusel muestra varias tarjetas en un desplazamiento horizontal, cada una con su propio medio, cuerpo y botones. Útil para mostrar catálogos, ofertas multiproducto o comparativas de características.
* **Hasta 10 tarjetas** por plantilla.
* Cada tarjeta tiene su propio encabezado de imagen o vídeo (un solo tipo de medio por plantilla — todas imágenes o todas vídeos, no mezclados).
* Cada tarjeta puede tener hasta **2 botones** (Respuesta rápida, URL o Teléfono).
* El cuerpo de cada tarjeta puede tener hasta 3 variables.
La aprobación se realiza por plantilla (no por tarjeta), por lo que todas las tarjetas deben cumplir con la categoría elegida.
### Plantillas de oferta por tiempo limitado (LTO)
Las plantillas LTO muestran un temporizador de cuenta regresiva debajo del cuerpo. Una vez que el temporizador expira, la oferta se muestra como expirada y pulsar el CTA no hace nada.
* Se requiere un parámetro de **código de oferta** que se muestra al usuario.
* Se requiere una **fecha de expiración en epoch (en segundos)**.
* El botón CTA suele ser un Copiar código o una URL.
Es lo mejor para ofertas genuinamente limitadas en el tiempo — usar LTO para ofertas que en realidad no expiran provoca quejas de usuarios y recategorización fuera de Marketing.
### Plantillas de código de cupón
Como LTO pero sin cuenta regresiva — simplemente un código que el usuario puede copiar con un solo toque.
* El código puede tener **hasta 20 caracteres** (recientemente aumentado desde 15).
* El botón Copiar código copia el valor que se proporciona en el **momento del envío** — el campo `example` de la plantilla es solo un marcador y nunca se envía.
* En la pestaña **Plantillas → Enviar** y en el **diálogo de plantilla del buzón**, las plantillas de código de cupón muestran una entrada dedicada de **Botones de código de cupón** donde escribes los códigos que realmente quieres enviar (uno por fila de destinatario para envíos masivos). Las etiquetas antiguas "Copiar código" / "Botones para copiar código de cupón" se han sustituido por este término único y coherente.
### Plantillas de autenticación
Plantillas especializadas para la entrega de OTP. Tres subtipos:
* **Autocompletar de un toque** — utiliza la API de autocompletado de Android para rellenar el OTP automáticamente cuando el usuario pulsa el botón. La mejor UX donde se admite.
* **Copiar código** — muestra un botón Copiar; el usuario pega el código en tu app. Funciona en todas partes.
* **Cero toques** — para remitentes de confianza, el OTP puede entregarse sin ningún toque (una devolución de llamada automática a la API desde el cliente de WhatsApp a tu app). Elegibilidad estricta.
Las plantillas de autenticación tienen el precio por mensaje más barato, pero las reglas de contenido más estrictas: nada de contenido de marketing, nada de texto extra en el cuerpo más allá del propio código.
### Plantillas de ubicación
Llevan una ubicación precisa en el encabezado, útil para visitas a tiendas, confirmaciones de entrega o lugares de eventos. El usuario puede abrir la ubicación en su app de mapas con un solo toque.
**El encabezado de ubicación como variables**
El encabezado LOCATION lleva hasta cuatro campos — **latitud**, **longitud**, **nombre** y **dirección** — y Flowella trata los cuatro como variables de plantilla normales.
* Los valores que escribiste en el editor (bajo `_flowellaEditor.headerLocationPreview`) pasan a ser los **predeterminados** que se envían si no se proporciona una sobrescritura.
* Los diálogos de **Probar plantilla** y de envío desde el buzón exponen los cuatro campos como entradas de variables normales.
* La acción [Enviar plantilla de WhatsApp](/hubspot/workflow-actions#send-whatsapp-template) de HubSpot pasa los cuatro valores a través de `headerLocation` para que un workflow pueda personalizar el pin por destinatario.
Si omites alguno de los cuatro en el momento del envío, Flowella recurre al valor de vista previa del editor para ese campo.
## Ciclo de vida del envío
Cuando envías una plantilla desde Flowella, pasa por estos estados:
Guardada en Flowella, pero aún no enviada a Meta.
Enviada a Meta y en revisión. La mayoría de las plantillas superan la revisión automática de Meta en minutos, pero algunas se derivan a revisión humana. El editor de Flowella te indica que la aprobación **puede tardar hasta 12 horas** y te **envía un correo electrónico** en cuanto cambia el estado — no necesitas estar actualizando la página.
Activa y usable. Puedes enviarla desde el buzón, la API y los workflows de HubSpot.
Meta rechazó la plantilla. El motivo del rechazo aparece en la página de la plantilla. Edita y vuelve a enviar.
Meta ha revisado los comentarios de calidad y ha marcado la plantilla. Normalmente es un paso previo a PAUSED.
Meta ha restringido temporalmente el envío de la plantilla, generalmente por comentarios de los destinatarios o baja calidad. Se reactiva automáticamente si la calidad se recupera.
Meta ha restringido la plantilla de forma permanente. Debe volver a enviarse como una nueva plantilla (a menudo recategorizada) si quieres volver a usar el contenido.
## Calificación de calidad
Una vez aprobada, cada plantilla acumula su propia calificación de calidad — separada de la [calificación de calidad del número de teléfono](/meta/quality-score). La calificación a nivel de plantilla usa la misma escala Verde/Amarillo/Rojo y está impulsada principalmente por:
* Tasa de bloqueo entre los destinatarios
* Frecuencia de acciones de "Reportar" en WhatsApp
* Baja interacción sostenida (sin respuestas, sin clics en enlaces)
Las calificaciones Amarilla y Roja pueden hacer que Meta pause la plantilla incluso si la calificación del propio número de teléfono es Verde. Vigila la calidad de la plantilla en **Flowella → Plantillas** junto con la calificación a nivel de número.
## Tiempo de vida (TTL)
Las plantillas pueden tener un **tiempo de vida** que controla cuánto tiempo intentará Meta la entrega antes de rendirse. Útil para envíos sensibles al tiempo, como invitaciones a ofertas relámpago.
* **Predeterminado:** 30 días para la mayoría de las plantillas.
* **Plantillas OTP / autenticación:** mucho más corto (unos pocos minutos por defecto), ya que los códigos no tienen valor una vez caducados.
* **TTL personalizado:** se puede establecer por envío para algunos tipos de plantilla.
Si una plantilla expira antes de la entrega (teléfono del destinatario sin conexión, cuenta pausada, etc.), cuenta como un envío para facturación, pero nunca llega al cliente.
## Motivos comunes de rechazo
* **Contenido promocional enviado como Utilidad.** Reenvíalo como Marketing.
* **Ejemplos de variables que no coinciden con el cuerpo** — por ejemplo, ejemplos que contienen enlaces que el cuerpo no justifica.
* **Texto del cuerpo o el encabezado que parece spam** — exceso de mayúsculas, "Haz clic aquí", "¡Gratis!!!", varios signos de exclamación.
* **URLs de encabezado de medios rotas o inaccesibles.**
* **Texto del pie de página que contradice el cuerpo.**
* **Plantillas genéricas** que cualquiera podría enviar — `Hola {{1}}, oferta especial para ti` sin detalles es demasiado genérico para la aprobación de marketing.
* **Variables en el contexto equivocado** — usar una variable en un lugar que Meta no permite (por ejemplo, algunos tipos de botón).
* **El nombre para mostrar no coincide con la marca** del contenido de la plantilla. Si el nombre para mostrar del WABA es "Acme" y la plantilla promociona "Beta Co", será rechazada.
Edita una copia de una plantilla APPROVED en lugar del original, para conservar una versión funcional mientras Meta revisa los cambios. **Plantillas → Duplicar** de Flowella lo hace por ti.
## Guías relacionadas
* [Plantillas](/app/templates) — los pasos detallados para construir una plantilla
* [Encabezados de medios](/app/media-in-template-headers) — referencia de formatos de medios
* [Plantilla rechazada](/troubleshooting/template-rejected) — diagnóstico de rechazos
* [Puntuación de calidad](/meta/quality-score) — cómo interactúa la calidad del número de teléfono con la calidad de la plantilla
* [Límites de mensajería](/meta/messaging-limits) — el sistema de niveles que limita cuántas plantillas puedes enviar