Skip to main content
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

Indica el idioma

El idioma es obligatorio en todo envío: agrega language en formato Meta lower_UPPER (ej. es_MX) para elegir cuál plantilla enviar.
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:
Los nombres de las plantillas los ves en el dashboard, que es donde se aprueban. Para saber qué variables espera una en concreto, consulta GET /templates/{name}/{language}.

​
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 /conversation) — 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 de plantillas 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 respuestas rápidas.

Conversaciones

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