Formatos de Archivo WhatsApp Cloud API: la Lista Completa
Los formatos de archivo WhatsApp Cloud API acepta están limitados a una lista específica por tipo de contenido, y mandar un archivo fuera de esa lista termina en un error, aunque el tamaño sea perfecto.
Por qué WhatsApp no acepta cualquier formato
La Cloud API no soporta cualquier tipo de archivo que exista, sino un grupo acotado de formatos por categoría, elegidos porque son los más compatibles con la enorme variedad de teléfonos y sistemas operativos donde corre WhatsApp. Un formato que se abre perfecto en una computadora puede no reproducirse igual en todos los celulares, así que Meta restringe la lista para asegurar que lo que se manda se vea o se escuche bien del otro lado.
Los formatos aceptados por tipo de contenido
Cada categoría de archivo, imagen, video, audio, documento o sticker, tiene su propia lista cerrada de formatos válidos. Conviene revisar esta lista antes de automatizar el envío de cualquier archivo generado por otro sistema, como un PDF armado por un ERP o un audio grabado con una herramienta de terceros.
| Tipo | Formatos aceptados |
|---|---|
| Imagen | JPEG, PNG |
| Video | MP4, 3GPP (códec de video H.264 y audio AAC) |
| Audio | AAC, MP4, MPEG, AMR, OGG (códec Opus) |
| Documento | PDF, Word, Excel, PowerPoint, texto plano, entre otros formatos de oficina |
| Sticker | WEBP |
Un audio grabado como nota de voz nativa de WhatsApp usa OGG con códec Opus: si tu sistema genera audios en otro formato para simular ese estilo de nota de voz, conviene convertirlos antes de mandarlos, o el agente puede terminar enviando un archivo de audio que no se reproduce como nota de voz dentro del chat.
Qué pasa si el formato no está soportado
La API rechaza el envío con un error, del mismo modo que pasa cuando un archivo supera el límite de tamaño permitido. No hay una conversión automática de formato de parte de Meta: si el archivo que se intenta mandar no está en la lista aceptada para esa categoría, hay que convertirlo antes, no después de que el envío falle.
Dónde suele aparecer este problema en la práctica
Es común que aparezca cuando se automatiza el envío de archivos generados por otro sistema, como capturas de pantalla en formato WEBP mandadas como si fueran fotos, o documentos exportados en formatos poco estándar desde un sistema de gestión viejo. Revisar el formato de salida de cada sistema conectado antes de integrarlo con el agente evita errores silenciosos que después son difíciles de diagnosticar.
La diferencia entre el formato del archivo y su extensión
Un error frecuente es confiar solo en la extensión del archivo, como ".mp4" o ".pdf", sin verificar que el contenido interno realmente esté codificado en el formato que esa extensión promete. Algunos programas exportan archivos con una extensión que no coincide del todo con el códec real usado adentro, y eso puede hacer que la Cloud API rechace un archivo que, a simple vista, parecía cumplir con la lista de formatos aceptados.
Cómo lo hace agenteala
agenteala valida que cada tipo de archivo que va a usar el agente, imágenes de catálogo, documentos de facturación, audios grabados, esté en un formato compatible con la Cloud API antes de dejarlo en producción, para que ningún envío falle por un detalle técnico evitable.
Preguntas frecuentes
¿Qué formatos de imagen acepta WhatsApp Cloud API?
JPEG y PNG son los formatos de imagen soportados.
¿Se puede mandar un video en cualquier formato?
No, solo MP4 y 3GPP, con códec de video H.264 y códec de audio AAC.
¿Qué formato de audio usa una nota de voz nativa de WhatsApp?
OGG con códec Opus es el formato que replica el estilo de nota de voz dentro del chat.
¿Qué pasa si mando un archivo en un formato no soportado?
La API rechaza el envío con un error; no hay conversión automática de formato de parte de Meta.
¿Los documentos aceptan cualquier tipo de archivo de oficina?
Se acepta PDF y los principales formatos de Word, Excel, PowerPoint y texto plano, entre otros formatos de oficina estándar.
Probá el agente antes de decidir
agenteala arma y mantiene el agente a la medida de tu negocio — no es un bot genérico: atiende, gestiona y vende por tu WhatsApp. Probalo en 2 minutos o hablá con un asesor.
Seguinos en Instagram @agenteala