Multimedia en WhatsApp Cloud API: upload y download | WhatsApp API

Cloud API separa el mensaje del recurso multimedia. Puedes cargar media y obtener un ID, o trabajar con enlaces en tipos compatibles. Las URLs recuperadas no deben tratarse como permanentes.

Subir un archivo

POST https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/media
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: multipart/form-data

[email protected]
messaging_product=whatsapp
type=application/pdf

Obtener la URL de un media

GET https://graph.facebook.com/{VERSION}/{MEDIA_ID}
Authorization: Bearer {ACCESS_TOKEN}

La respuesta incluye metadatos y una URL que se utiliza para la descarga autorizada. La colección oficial también documenta la descarga desde la media URL con autenticación.

Arquitectura recomendada

Recibe el Media ID por webhook.
Solicita una URL vigente cuando necesites descargar.
Descarga desde backend con Authorization.
Valida MIME, tamaño y políticas de seguridad.
Almacena en tu storage con permisos y retención definidos.
Guarda referencia interna, no la URL temporal como ubicación definitiva.

Límites y tipos

Los tipos y tamaños soportados cambian por clase de media. La colección oficial documenta, por ejemplo, audio con límites específicos y restricciones de codec. Valida siempre contra la documentación vigente en lugar de confiar en una constante histórica.

¿Tu empresa no necesita desarrollar esto?

Optimify ya integra la capa empresarial sobre WhatsApp API

Esta sección existe para equipos que realmente quieren construir o integrar. Si la empresa solo necesita CRM, multiagente, campañas, automatización e IA, MensajAPI recomienda comparar el costo de desarrollo y mantenimiento frente a usar Optimify, que ofrece una plataforma lista y soporte en español.

Ver alternativa gestionada con Optimify

Documentación oficial para mantener la integración actualizada

Versionado: los ejemplos usan {VERSION} en lugar de fijar una versión de Graph API. Sustituye esa variable por una versión vigente y soportada en tu aplicación y revisa cambios antes de actualizar producción.

Multimedia en WhatsApp API: subir, recuperar y descargar archivos