Crear plantilla
POST/templates
Crea una plantilla en Meta. Nace con estado PENDING y la aprobación tarda de
minutos a horas — el resultado llega por el webhook
message_template_status_update.
Antes de enviarla a Meta validamos los componentes localmente y devolvemos
422 invalid_request con un campo issues que señala el problema. Eso evita el
ciclo lento de enviar, esperar y ser rechazado.
Qué se valida
- Variables sin ejemplo declarado
- Ejemplos con valor vacío
- Huecos en la numeración posicional (
{{1}},{{3}}sin{{2}}) - Mezcla de formato posicional y nombrado en la misma plantilla
- Más de una variable en la cabecera de texto
- Cualquier variable en el pie
- Botón de URL con variable y sin ejemplo de URL
- Identificador inválido en una variable nombrada
- Un
parameterFormatdeclarado que contradice el texto
A partir de la biblioteca de Meta
En lugar de components puedes enviar libraryTemplateName con el nombre de un
elemento de GET /templates/library. Entonces el texto es de Meta y no pasa por
ninguna validación nuestra — lo que completas es solo lo que el modelo pide (URL
del botón, teléfono). Los dos caminos se excluyen: enviar ambos da 422.
Request
Responses
- 201
- 401
- 403
- 409
- 422
- 429
Plantilla creada, a la espera de aprobación.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
El recurso no pertenece a tu cuenta (forbidden), o la ruta está en la lista de
bloqueo del espejo (forbidden_endpoint), o tu API key está restringida a algunos
números y la operación es de toda la cuenta (forbidden).
Ninguna cuenta de WhatsApp Business conectada y wabaId omitido (no_waba).
El payload no pasó la validación (invalid_request, detallado en issues) o fue
rechazado por Meta (meta_error, con el cuerpo original en meta).
Límite de peticiones superado (rate_limit).
Response Headers
Segundos a esperar antes de reintentar.
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.