Ciclo de vida
Importada
Nuntia valida y conserva la definición.
Enviada
Se registra en el WABA conectado.
Revisada
Meta aprueba, pausa o rechaza.
Usable
Solo una versión aprobada se puede enviar.
Importar un manifiesto
Una plantilla necesita name, language, category y componentes. Puedes importarla sin número para dejarla preparada. Usa submit_to_meta: true únicamente cuando el workspace ya tenga un número activo con WABA y token.
{
"phone_number_id": "<connected-phone-number-id>",
"submit_to_meta": true,
"manifest": {
"templates": [{
"name": "<approved-template-name>",
"language": "es_PE",
"category": "UTILITY",
"components": [{
"type": "BODY",
"text": "Hola {{1}}, tu pedido {{2}} ya está en camino.",
"example": {"body_text": [["<customer-name>", "<order-reference>"]]}
}]
}]
}
}Consultar y sincronizar
GET /api/v1/templates lista el inventario del workspace. POST /api/v1/templates/sync consulta a Meta para actualizar estados y motivos de rechazo cuando estén disponibles.
Estados como APPROVED, PENDING, REJECTED y PAUSED proceden de Meta. pending_phone_number significa que la definición está preparada en Nuntia pero aún no existe un número/WABA donde registrarla.
Enviar una plantilla aprobada
{
"phone_number_id": "<connected-phone-number-id>",
"to": "<customer-phone>",
"client_reference": "<client-reference>",
"template": {
"name": "<approved-template-name>",
"language": "es_PE",
"body_parameters": ["<customer-name>", "<order-reference>"]
}
}Las plantillas pertenecen al WABA donde fueron aprobadas. Una definición aprobada para otro negocio o número no se reutiliza automáticamente.