Plantillas de Mensajes
Subir Media
Sube un archivo (imagen, video o documento) y obtén una URL pública para usarla como media_url al enviar una plantilla
POST
Sube un archivo a almacenamiento y devuelve una URL pública lista para usarse en el campo
media_url de Enviar Plantilla.
Existe porque media_url exige una URL https:// accesible por los servidores de Meta — una imagen en tu disco local o en un servidor privado no sirve. Este endpoint es el paso previo: subes el archivo una vez, obtienes la URL, y la reutilizas en cuantos envíos necesites.
Autenticación
Requiere el encabezadox-api-key con el App Key del negocio. Consulta Autenticación.
Encabezados
string
required
App Key del negocio. Consulta Autenticación.
Cuerpo de la solicitud
Este endpoint recibemultipart/form-data, no JSON.
file
required
El archivo a subir. Tipos aceptados:
image/jpeg, image/jpg, image/png, video/mp4, application/pdf — los mismos que soporta un encabezado de plantilla de WhatsApp. Cualquier otro tipo se rechaza con 400.Respuesta
boolean
true cuando el archivo se subió correctamente.string
URL pública
https:// del archivo. Pásala directamente en media_url al enviar la plantilla.string
Nombre interno con el que se guardó el archivo.
Errores comunes
La URL devuelta es permanente: el archivo no se borra automáticamente y puede reutilizarse en múltiples envíos de
media_url.