Skip to main content
POST
Subir multimedia para plantilla

Conceptos

Meta no acepta el archivo directamente al crear la plantilla. Exige un header_handle producido por la Resumable Upload API, que depende del token de la aplicación; por eso la subida pasa por aquí y no por tu frontend. Este endpoint recibe el archivo y devuelve el handle listo para usar.

Cuándo lo necesitas

Solo cuando la plantilla tiene un componente HEADER de tipo IMAGE, VIDEO o DOCUMENT. Las plantillas con header de texto, o sin header, no necesitan subida.

Flujo

1

Sube el archivo

POST /whatsapp/businesses/{wabaId}/templates/media con multipart/form-data, campos file y type.
2

Guarda el handle

La respuesta trae el handle en el campo h.
3

Úsalo en el componente HEADER

Pasa el handle como example del HEADER en Crear plantilla:
El handle caduca. Sube el archivo y crea la plantilla en la misma sesión: no guardes el handle para usarlo días después.
Además de h, la API acepta el handle en las claves handle, header_handle, headerHandle y mediaHandle. Usa h, que es la forma canónica.

Requisito de configuración

La subida depende del App ID y el App Secret de Meta registrados en la cuenta. Sin ellos, la llamada devuelve 422 con MISSING_APP_CREDENTIALS. Esto se configura en el panel, en Seguridad: no hay endpoint público para registrar las credenciales del app. Consulta también Orígenes del SDK, que cubre el otro requisito del flujo con SDK.

Límites

Autorizaciones

Authorization
string
header
requerido

Secret Key generada en el panel de Seguridad de Omni Z-API

Parámetros de ruta

wabaId
string
requerido

ID de la WABA (obtenido con Listar WABAs)

Ejemplo:

"428083093730937"

Cuerpo

multipart/form-data
file
file
requerido

Archivo del header (imagen, vídeo o documento). Límite de 100 MB

type
string
requerido

MIME type del archivo (p. ej.: image/jpeg, video/mp4, application/pdf)

Ejemplo:

"image/jpeg"

Respuesta

Subida completada

h
string

Handle que se usa como example del componente HEADER al crear la plantilla