Enviar multimedia: imágenes, vídeo, audio y documentos
La multimedia se envía de dos formas: subiendo el archivo primero y referenciando el id que devuelve, o dándole a Meta un enlace público que ir a buscar. Subir el archivo es más fiable, y los límites de tamaño varían por tipo de un modo que pilla a la gente por sorpresa.
El tope de tamaño de imagen en la Cloud API.
El tope para vídeo y audio.
El tope para documentos.
Los límites, por tipo
Distintos para cada uno, y superar cualquiera de ellos devuelve el error 131053 en lugar de algo descriptivo.
- Imágenes: 5 MB. JPEG y PNG.
- Vídeo: 16 MB. MP4 y 3GPP, con vídeo en H.264 y audio en AAC.
- Audio: 16 MB. AAC, AMR, MP3, audio MP4 y OGG con Opus.
- Documentos: 100 MB. La mayoría de los tipos de documento comunes, incluidos PDF y formatos de Office.
- Stickers: 100 KB animados, 500 KB estáticos, solo WebP.
Subir frente a enlazar
Dos formas de enviar el mismo archivo, y fallan de maneras distintas.
Subir manda el archivo a Meta primero y devuelve un id de medio que referencias al enviar. Enlazar le da a Meta una URL que ir a buscar en el momento del envío. La vía del enlace parece más sencilla y añade un modo de fallo que no puedes ver: una URL que abre en tu navegador puede ser inalcanzable desde la infraestructura de Meta por geografía, por una regla de firewall o por una cookie de sesión que tu navegador ya tiene.
Sube el archivo. Es una petición más y elimina una clase entera de fallos.
Recibir multimedia
La multimedia entrante llega como un id de medio y no como bytes. Tu handler busca el archivo por separado usando ese id.
- Búscalo pronto. Los ids no siguen siendo válidos indefinidamente.
- Una búsqueda fallida devuelve el error 131052, que normalmente significa que la subida del remitente quedó incompleta.
- Guarda el archivo por tu cuenta si vas a necesitarlo después. Meta no es un archivo histórico.
- Registra el mensaje incluso cuando la búsqueda de multimedia falle, para que el texto y el contexto sobrevivan.
Qué cambia la Coexistencia
La multimedia en un número en Coexistencia funciona exactamente igual que en cualquier otro número de la Cloud API, con los mismos límites.
La única diferencia que vale la pena conocer es el historial. Cuando un número se conecta por primera vez, Meta sincroniza los mensajes recientes de la app de WhatsApp Business, y esa sincronización cubre el texto de los mensajes en lugar de ser un archivo completo de multimedia. La multimedia anterior a la conexión sigue en el teléfono, donde siempre estuvo.
Errores comunes
- Mandar un enlace porque parece más sencillo. La red de Meta no es tu navegador.
- Buscar la multimedia entrante horas después. Los ids de medio caducan.
- Exportar vídeo sin comprobar el códec. Los valores por defecto de los editores muchas veces no están admitidos.
EasyCoexistence entrega los eventos de mensaje entrante directamente desde Meta a tu endpoint, así que los ids de medio llegan a tu sistema de inmediato y pueden buscarse mientras siguen siendo válidos.
Preguntas frecuentes
¿Cuál es el archivo más grande que puedo enviar?
100 MB, y solo para documentos. El vídeo y el audio se topan en 16 MB y las imágenes en 5 MB.
¿Debo subir el archivo o mandar una URL?
Súbelo. Eso elimina la alcanzabilidad como causa de fallo.
¿Cuánto tiempo es válido un id de medio?
No indefinidamente, y por eso la multimedia entrante debe buscarse en cuanto llega el evento.
¿La multimedia antigua se sincroniza al conectar?
No. La sincronización de historial cubre el contenido de los mensajes recientes; la multimedia anterior a la conexión se queda en el teléfono.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el