Saltar al contenido principal
Una plantilla es un mensaje preaprobado por Meta. Es el único tipo de mensaje que puedes enviar cuando la ventana de 24 horas está cerrada — es decir, cuando el contacto no te escribió en las últimas 24 horas. Mientras la ventana está abierta puedes enviar texto libre; una vez cerrada, solo una plantilla llega al cliente.
Las plantillas se crean y se aprueban en el dashboard. La API pública solo las consume para enviar — no las crea ni las edita.

​
Cómo se resuelve una plantilla

1

Identifica la plantilla por nombre

Una plantilla se identifica por su template_name — el mismo nombre que ves en el dashboard y que reportas a Meta.
2

Especifica el idioma si hace falta

Si el mismo nombre está aprobado en varios idiomas, agrega language (formato Meta lower_UPPER, ej. es_MX) para elegir cuál enviar. Si solo existe en un idioma, es opcional.
3

Verifica que esté aprobada

Solo se pueden enviar plantillas en estado APPROVED. Una en PENDING o REJECTED no es enviable.

​
Componentes de una plantilla

Al enviar una plantilla rellenas sus partes dinámicas:

body_variables

Los placeholders del cuerpo ({{1}}, {{2}}, …). Array de objetos { index, value }.

header

El encabezado: texto, o media vía file_uuid.

button_parameters

Parámetros de botones dinámicos (ej. el sufijo de un botón URL).

​
Enviar una plantilla

Un envío típico, con dos variables en el cuerpo:
Para descubrir qué plantillas tienes disponibles y qué variables espera cada una, consulta los endpoints de catálogo de plantillas en la Referencia de API.

​
Plantillas de prueba para conversaciones tester

El dashboard permite crear plantillas de prueba (status: FAKE) desde el módulo Tester sin pasar por la aprobación de Meta. Sirven para que el operador y los integradores prueben flujos contra conversaciones tester sin esperar la revisión de Meta. Reglas de envío vía API pública:
  • Conversación tester (is_tester: true en GET /conversations) — puedes enviar tanto plantillas APPROVED como plantillas FAKE. El envío replica el flujo real pero no toca Meta (wamid retorna "").
  • Conversación real (is_tester: false) — solo plantillas APPROVED. Si intentas enviar una plantilla FAKE o una plantilla con is_tester: true a una conversación real, la API responde con TEMPLATE_FAKE_REQUIRES_TESTER_CONVERSATION (422).
El catálogo público (GET /templates y GET /templates/{name}/{language}) no incluye plantillas FAKE — solo las APPROVED reales. Si necesitas el nombre de una plantilla FAKE para enviarla, consulta al operador.

​
Próximos pasos

Enviar mensajes

El envío de plantillas, texto, media y quick replies.

Conversaciones

La ventana de 24 horas y el estado de una conversación.