Saltar al contenido
OmniChannels.ai
Menú

API de WhatsApp Business

¿Cuáles son los límites de tamaño de los archivos multimedia de la API de WhatsApp?

Actualizado

Respuesta breve

La documentación de Meta indica estos tamaños máximos para los archivos multimedia de la API WhatsApp Cloud en el momento de redactar: imágenes 5 MB (JPEG, PNG, WebP estático), vídeo 16 MB (MP4 o 3GPP con H.264 y AAC), audio 16 MB, documentos 100 MB, stickers animados 500 KB y stickers estáticos 100 KB. Suba el archivo y envíe su ID de medio en lugar de un enlace, y compruebe que el tipo MIME coincide con el archivo.

Límites de tamaño por tipo de archivo

El tope de la API Cloud para cualquier archivo es de 100 MB. Un archivo puede cumplir el límite de tamaño y aun así ser rechazado por su formato, por ejemplo un vídeo que no sea H.264 con audio AAC o una imagen que no sea RGB o RGBA de 8 bits.

Tipo de archivoTamaño máximoNotas
Imagen5 MBSolo RGB o RGBA de 8 bits
Vídeo16 MBVídeo H.264, audio AAC
Audio16 MBAAC, AMR, MP3, M4A, OGG con códec Opus
Documento100 MBArchivos de Office, PDF y texto
Sticker (animado)500 KBSolo WebP
Sticker (estático)100 KBSolo WebP

Subir o enlazar, y cuánto duran los ID

Meta recomienda subir el archivo y enviar su ID de medio para obtener mejor rendimiento. Los ID que devuelve una subida son válidos durante 30 días, y los recibidos en webhooks entrantes durante 7 días, así que descargue enseguida los archivos de los clientes. Una URL de descarga caduca a los 5 minutos.

Los pies de imagen, vídeo y documento pueden tener hasta 1.024 caracteres. Los mensajes de audio y de sticker no llevan pie.

Errores frecuentes

  • Juzgar solo por el tamaño e ignorar el códec o el formato de color.
  • Servir un archivo con un tipo MIME que no coincide, una causa habitual del error 131053.
  • Depender de un ID de medio con más de 30 días.
  • Enviar un WebP animado como imagen, que se rechaza.

Fuentes oficiales