--- title: "API de WhatsApp: formatos de archivo y límites de tamaño" description: "Límites de tamaño y formatos admitidos por la API de WhatsApp para imágenes, vídeo, audio, documentos y stickers, más envío por ID o enlace y pies de foto." canonical: "https://omnichannels.ai/es/blog/whatsapp-media-messages-file-types-size-limits/" language: "es" updated: "2026-11-07" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "límite de tamaño de archivos api whatsapp" keywords: ["formatos de archivo admitidos api whatsapp", "multimedia whatsapp cloud api", "tamaño máximo de vídeo whatsapp", "tamaño máximo de documento whatsapp", "tamaño de sticker whatsapp", "caducidad id de medio whatsapp", "imagen de encabezado plantilla whatsapp", "error 131053 whatsapp"] published: "2026-11-07" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "Según la documentación de Meta en el momento de redactar este texto, los tamaños máximos de los archivos multimedia de la API Cloud de WhatsApp son: 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." takeaways: ["Según la documentación de Meta en el momento de redactar este texto, los límites son 5 MB para imágenes, 16 MB para vídeo y audio, 100 MB para documentos y 500 KB (animado) o 100 KB (estático) para stickers.", "El vídeo debe ser H.264 con audio AAC y las imágenes RGB o RGBA de 8 bits; un archivo que cumple el límite de tamaño aún puede ser rechazado por su códec o su formato de color.", "Meta recomienda enviar los archivos subidos por ID en lugar de por enlace, para un mejor rendimiento.", "Los ID de medio devueltos por una subida caducan a los 30 días, y los recibidos en webhooks entrantes a los 7 días, así que descargue cuanto antes los archivos de sus clientes.", "Los pies de foto de imágenes, vídeos y documentos están limitados a 1.024 caracteres, y el error 131053 suele indicar un tipo MIME que no coincide con el archivo."] faq: - q: "¿Cuál es el límite de tamaño de archivo de la API de WhatsApp?" a: "Depende del tipo. La documentación de Meta indica 5 MB para imágenes, 16 MB para vídeo y audio, 100 MB para documentos, y 500 KB para stickers animados o 100 KB para estáticos. El techo de la API Cloud para archivos multimedia es de 100 MB. Los límites pueden cambiar, así que confírmelos en la referencia vigente de Meta antes de programar reglas de validación." - q: "¿Qué formatos de archivo admite la API de WhatsApp Business?" a: "Imágenes: JPEG, PNG y WebP estático. Vídeo: MP4 y 3GPP con vídeo H.264 y audio AAC. Audio: AAC, AMR, MP3, M4A y OGG con códec Opus. Documentos: TXT, XLS, XLSX, DOC, DOCX, PPT, PPTX y PDF. Stickers: solo WebP. Todo lo que quede fuera de estas listas se rechaza, así que convierta el archivo antes de enviarlo." - q: "¿Debo enviar un archivo por enlace o por ID de medio?" a: "La documentación de Meta recomienda un ID de medio subido, por su mejor rendimiento. Un enlace debe apuntar a un archivo en un servidor público, de modo que la plataforma tiene que descargarlo en el momento del envío. Un ID hace referencia a un archivo ya almacenado en Meta. Los ID obtenidos al subir un archivo son válidos 30 días; después hay que volver a subirlo." - q: "¿Cuánto tiempo es válido un ID de medio de WhatsApp?" a: "Meta documenta 30 días para los ID devueltos al subir un archivo y 7 días para los ID de medio recibidos en webhooks entrantes. Los archivos subidos se conservan 30 días, salvo que los elimine antes. La URL de descarga que se obtiene a partir de un ID caduca a los 5 minutos, así que solicite una nueva cada vez que necesite el archivo." - q: "¿Puedo añadir un pie de foto a una imagen o un vídeo de WhatsApp?" a: "Sí. La referencia de mensajes de Meta contempla un pie de foto opcional de hasta 1.024 caracteres en los mensajes de imagen, vídeo y documento. Los mensajes de audio y de sticker no admiten pie de foto. Si necesita texto junto a un sticker o una nota de voz, envíe a continuación un mensaje de texto aparte." - q: "¿Qué significa el error 131053 de WhatsApp?" a: "Meta lo describe como la imposibilidad de subir el archivo multimedia usado en el mensaje. La causa habitual es un tipo MIME que no coincide con la extensión del archivo, o un tipo no admitido. Revise el detalle del error en el webhook correspondiente, confirme el formato en los tipos de archivo admitidos por Meta y vuelva a codificar el archivo si hace falta." sources: - title: "Media — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media" - title: "Image messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages" - title: "Video messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages" - title: "Document messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages" - title: "Error codes — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes" --- # API de WhatsApp: formatos de archivo y límites de tamaño Canonical: https://omnichannels.ai/es/blog/whatsapp-media-messages-file-types-size-limits/ Language: es Publisher: OmniChannels.ai by BroadNet Technologies Esta guía está pensada para desarrolladores y equipos de marketing que envían imágenes, vídeo, audio, documentos o stickers a través de la API de WhatsApp Business y quieren evitar envíos fallidos. Recoge los formatos de archivo y los límites de tamaño que documenta Meta, explica la diferencia entre subir un archivo y enviar un enlace, los ID de medio, los pies de foto y los encabezados de plantilla, y muestra cómo gestionar los archivos que le envían sus clientes. Todas las cifras de abajo son los valores documentados por Meta en el momento de redactar este texto (7 de noviembre de 2026). Meta puede cambiarlos, así que considere la [referencia de archivos multimedia](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media) como la fuente de autoridad. ## ¿Cuáles son los límites de tamaño de los archivos multimedia de la API de WhatsApp? Cada tipo de archivo tiene su propio tope, y el techo de la API Cloud para cualquier archivo multimedia es de 100 MB. Los documentos tienen el mayor margen y los stickers el menor. | Tipo de archivo | Tamaño máximo | Notas | |---|---|---| | Imagen | 5 MB | Solo RGB o RGBA de 8 bits | | Vídeo | 16 MB | Vídeo H.264, audio AAC | | Audio | 16 MB | Varios formatos, véase abajo | | Documento | 100 MB | Archivos de Office, PDF y texto | | Sticker (animado) | 500 KB | Solo WebP | | Sticker (estático) | 100 KB | Solo WebP | Un archivo puede cumplir el límite de tamaño y aun así fallar por el formato. Las secciones siguientes detallan los formatos aceptados para cada tipo. ## ¿Qué formatos de imagen y de sticker se admiten? Las imágenes pueden ser JPEG, PNG o WebP estático, de hasta 5 MB, y deben ser RGB o RGBA de 8 bits. Los stickers deben ser WebP. | Tipo | Extensión | Tipo MIME | |---|---|---| | JPEG | .jpeg | `image/jpeg` | | PNG | .png | `image/png` | | WebP estático | .webp | `image/webp` | Meta documenta tres reglas más para las imágenes. Un WebP estático enviado en un mensaje de imagen se transcodifica a JPEG. Se rechazan los archivos WebP animados, los WebP que no se pueden decodificar y las imágenes de más de 4.096 píxeles en cualquier lado. Para los stickers, use WebP con `image/webp`: hasta 500 KB si es animado y 100 KB si es estático. Si sus recursos de marca son PNG pesados exportados desde una herramienta de diseño, exporte un JPEG de tamaño web en lugar de enviar el original. ## ¿Qué formatos de vídeo y audio se admiten? El vídeo es MP4 o 3GPP, de hasta 16 MB. El audio puede ser AAC, AMR, MP3, M4A u OGG con códec Opus, también de hasta 16 MB. | Tipo | Extensión | Tipo MIME | |---|---|---| | Vídeo MP4 | .mp4 | `video/mp4` | | Vídeo 3GPP | .3gp | `video/3gpp` | | Audio AAC | .aac | `audio/aac` | | Audio AMR | .amr | `audio/amr` | | Audio MP3 | .mp3 | `audio/mpeg` | | Audio MP4 | .m4a | `audio/mp4` | | Audio OGG | .ogg | `audio/ogg` | Para el vídeo, Meta exige el códec H.264 y audio AAC, con una sola pista de audio o ninguna. Meta también desaconseja el perfil H.264 «High» con fotogramas B, porque los clientes de WhatsApp para Android no lo admiten; use «Main» sin fotogramas B, o «Baseline». Coloque los átomos `moov` antes que los `mdat`, lo que con ffmpeg equivale a la opción `-movflags faststart`. Para OGG, solo se admite el códec Opus, el tipo base `audio/ogg` no, y la entrada debe ser mono. ## ¿Qué formatos de documento se admiten? Los documentos pueden ser PDF, Word, Excel, PowerPoint o texto plano, de hasta 100 MB. | Tipo | Extensión | Tipo MIME | |---|---|---| | PDF | .pdf | `application/pdf` | | Word | .doc, .docx | `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | | Excel | .xls, .xlsx | `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | | PowerPoint | .ppt, .pptx | `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation` | | Texto | .txt | `text/plain` | Los mensajes de documento admiten un nombre de archivo opcional con su extensión, y el cliente de WhatsApp elige el icono del archivo según esa extensión. Elija un nombre legible como `invoice-2026-1042.pdf`, porque el cliente lo ve. ## ¿Debo subir el archivo o enviar un enlace? Meta recomienda subir el archivo y enviar su ID de medio. También puede enviar un enlace a un archivo alojado en un servidor público, pero las referencias de Meta para imágenes, vídeo y documentos indican que se prefiera el ID subido por su mejor rendimiento, y su guía sobre el rendimiento dice lo mismo para volúmenes altos. | | ID de medio | Enlace | |---|---|---| | Cómo funciona | Primero se sube y luego se usa el ID devuelto | Apunta a una URL pública; el archivo se descarga al enviar | | Guía de Meta | Recomendado | Admitido, no recomendado | | Validez | 30 días desde la subida | Mientras su servidor siga sirviendo el archivo | | Modo de fallo | ID caducado o no válido | URL inaccesible, lenta o con tipo incorrecto | Con el punto de conexión de Meta, una subida es un `POST` a `//media` con el archivo, su tipo MIME y `messaging_product=whatsapp`, y la respuesta es `{"id": ""}`. Los archivos subidos se cifran y se conservan 30 días, salvo que los elimine antes. En el punto de conexión de WhatsApp de OmniChannels.ai, un mensaje multimedia lleva `mediaUrl` (una URL HTTPS pública) o `mediaFile` (un archivo que sube junto con la solicitud), con el pie de foto en `content`. Consulte la [documentación de la API de WhatsApp](/developers/whatsapp/). Pregunte a nuestro equipo cómo gestiona su cuenta el almacenamiento y la reutilización de archivos en envíos grandes. ## ¿Cuánto tiempo son válidos los ID de medio? Meta documenta 30 días para un ID devuelto por una subida y 7 días para un ID recibido en un webhook entrante. La URL de descarga que se devuelve para un ID caduca a los 5 minutos. Consecuencias prácticas: - No guarde en caché un ID de medio durante meses. Conserve su archivo original y vuelva a subirlo cuando se rechace un ID. - Descargue los archivos entrantes en cuanto llegue el evento y guarde su propia copia. - No almacene nunca una URL de descarga obtenida; pida una nueva cuando la necesite. ## ¿Puedo añadir pies de foto a los mensajes multimedia? Sí. Los mensajes de imagen, vídeo y documento admiten un pie de foto opcional de hasta 1.024 caracteres, según las referencias de mensajes de Meta. Los pies de foto son texto plano junto al archivo. Los mensajes de audio y de sticker no tienen pie de foto en este modelo. Si necesita acompañar una nota de voz con palabras, envíe un mensaje de texto breve a su lado. Dentro de la [ventana de atención al cliente](/es/blog/whatsapp-24-hour-customer-service-window/) los pies de foto son libres; fuera de ella, el archivo debe viajar dentro de una plantilla aprobada. ## ¿Cómo funcionan los archivos multimedia en las plantillas de mensaje? Una plantilla puede llevar una imagen, un vídeo o un documento en el encabezado, y ese encabezado queda fijado al crear la plantilla. Al enviar una plantilla a aprobación, usted aporta un archivo de muestra, y puede indicar el archivo real al enviar. En nuestra API, `headerFormat` puede ser `IMAGE`, `VIDEO` o `DOCUMENT` al crear la plantilla, `headerFile` lleva la muestra, y `mediaUrl` en el momento del envío sustituye el archivo del encabezado. Consulte la documentación de plantillas de Meta para conocer los requisitos de los archivos de muestra. Véanse [categorías de plantillas y aprobación](/es/blog/whatsapp-template-categories-approval/) y [ejemplos de plantillas](/es/blog/whatsapp-message-template-examples/). ## ¿Cómo descargo un archivo que envía un cliente? Un archivo entrante llega mediante un webhook con un ID de medio; usted lo convierte en una URL y lo descarga con autorización. 1. Lea el ID de medio del evento del mensaje entrante. 2. Solicite la URL del archivo para ese ID. La respuesta de Meta incluye `url`, `mime_type`, `sha256` y `file_size`. 3. Envíe un `GET` a esa URL con una cabecera `Authorization: Bearer `. Sin el token, la solicitud falla. 4. Compruebe la cabecera `Content-Type` y el valor `sha256`, y después guarde el archivo. 5. Si recibe un `404`, solicite una URL nueva y reintente; si sigue fallando, renueve el token de acceso. El tamaño máximo de archivo entrante en la API Cloud es de 100 MB según Meta. Un archivo mayor activa un webhook con el código de error `131052`; pida al cliente que envíe un archivo más pequeño o que lo comparta de otra forma. Analice cada archivo antes de abrirlo internamente. Véase la [guía de webhooks](/es/blog/whatsapp-webhooks-guide/) y confirme con su ingeniero de incorporación cómo se entregan los archivos entrantes en su cuenta. ## Ejemplo práctico: una clínica dental que envía informes «Nile Smile Clinic» (sintética), en El Cairo, envía tarjetas de cita e informes de radiografías. 1. Las tarjetas de cita son imágenes PNG de 300 KB con un pie de foto de dos líneas. Muy por debajo de 5 MB. 2. Los informes de tratamiento son PDF de 2 a 8 MB, llamados `report-2026-0381.pdf`, enviados como documentos. 3. Un vídeo de 25 MB con un recorrido por la clínica es demasiado grande para un vídeo. El equipo lo recodifica como MP4 H.264/AAC de menos de 16 MB con `faststart`. 4. Los pacientes envían fotos de recetas. La bandeja de entrada descarga cada archivo de inmediato, porque el ID entrante caduca a los 7 días. 5. Un saludo de voz se exporta como OGG Opus mono, porque se rechazan las demás variantes de OGG. ## ¿Cuáles son los errores más comunes? - **Juzgar solo por el tamaño.** Una imagen de 3 MB en el formato de color equivocado o un vídeo con el códec incorrecto falla igualmente. - **Desajuste de tipo MIME.** Un `.jpg` servido como `application/octet-stream` es una causa clásica del error 131053. - **Enlazar a una URL lenta o privada,** como un enlace firmado que ha caducado o una página tras un inicio de sesión. - **Confiar en un ID de medio antiguo.** Los ID caducan a los 30 días. - **Ignorar la caducidad de los entrantes.** Los archivos de los clientes deben guardarse en un plazo de 7 días. - **Un WebP animado como imagen.** Se rechaza; use un sticker o un vídeo. - **Los límites cambian.** Vuelva a consultar la referencia de Meta antes de fijar las validaciones en el código. ## Cómo le ayuda OmniChannels.ai OmniChannels.ai envía mensajes de WhatsApp de imagen, vídeo, audio, documento y sticker mediante una sola API, con un enlace público o un archivo subido y un pie de foto, y muestra los archivos multimedia y los adjuntos en la bandeja de entrada compartida. BroadNet es un Business Solution Provider oficial de Meta, por lo que las plantillas con encabezado de imagen, vídeo o documento pueden crearse y seguirse con su estado de aprobación. Lea la [documentación de la API de WhatsApp](/developers/whatsapp/) y los [errores y límites](/developers/errors-and-limits/), o conozca el [canal de WhatsApp](/es/channels/whatsapp-business-api/).