Tres cosas se llaman «plantilla»
Meta usa la misma palabra para tres recursos distintos. Confundirlos es la causa más habitual de error en la integración:1 y 2 — plantillas preaprobadas
Sirven al mismo propósito: hablar con el cliente fuera de la ventana de conversación. Las dos exigen registro previo y aprobación de Meta. La diferencia práctica es el alcance. La plantilla de WhatsApp pertenece a una WABA; la Utility Template pertenece a una página de Facebook. La Utility Template tiene un ciclo de vida bastante más rico que la de WhatsApp: 10 estados frente a 3:PENDING · APPROVED · REJECTED · IN_APPEAL · PAUSED · DISABLED · LIMIT_EXCEEDED · ARCHIVED · PENDING_DELETION · DELETED
También acepta parameter_format (NAMED o POSITIONAL) y permite clonar de la biblioteca preaprobada de Meta con library_template_name.
En Messenger, la Utility Template sustituyó a las Message Tags. Las etiquetas
CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE y POST_PURCHASE_UPDATE se descontinuaron el 27 de abril de 2026 y ahora devuelven el error 100. Si tu integración todavía usa etiquetas, ya está rota.3 — mensaje estructurado (sin aprobación)
Es lo que Meta también llama generic template y button template. No es una plantilla preaprobada: es un formato de payload enviado inline, para poner botones y tarjetas en un mensaje que ya puedes enviar. En Omni Z-API son los endpoints interactivos, disponibles en los cinco canales sin registro:Enviar texto con botones
Botones de respuesta rápida: el button template de Meta.
Enviar botones de acción
Botones de URL y de llamada: el generic template de Meta.
Consulta la matriz de capacidades para ver qué admite cada canal.
¿Qué son las plantillas de WhatsApp?
En la API oficial de WhatsApp solo puedes enviar mensajes con total libertad mientras la ventana de conversación de 24 horas esté abierta (es decir, cuando el cliente te ha escrito recientemente). Fuera de esa ventana, la única forma de iniciar una conversación es mediante plantillas: mensajes predefinidos que Meta debe aprobar antes de que puedas enviarlos.Categorías
Cada plantilla necesita una categoría que define el tipo de comunicación. Elegir la categoría equivocada puede hacer que Meta rechace tu plantilla.Estructura de una plantilla
Toda plantilla se compone de components. Cada componente cumple una función:Placeholders
Puedes usar variables dinámicas en el texto con{{1}}, {{2}}, etc. Al crear la plantilla es obligatorio enviar ejemplos reales para cada placeholder: Meta los utiliza durante la revisión.
Flujo de una plantilla
La API organiza las plantillas por business (WABA, o cuenta de WhatsApp Business). Cada business tiene sus propias plantillas, su historial de aprobación y sus límites.1
Identifica tu WABA
Usa el endpoint de listar WABAs para obtener el
businessId que corresponde a tu token.2
Crea la plantilla
Elige la categoría, arma los components con sus placeholders y ejemplos, y envíala a aprobación.
3
Espera la aprobación
Meta revisa la plantilla y devuelve un estado:
PENDING, APPROVED o REJECTED.4
Envía mensajes
Con la plantilla aprobada ya puedes usarla para iniciar conversaciones con clientes fuera de la ventana de 24 h.