WhatsApp business API: Envio de mídias
Updated
by Michelli Silva
Envío de medios
Es posible enviar medios (audios, videos e imágenes) a través de WhatsApp según las restricciones impuestas por la plataforma. El límite máximo de carga es de 32 MB o 30 segundos intentando realizar la carga. ¿Qué significa esto? Si el archivo tiene menos de 32 MB pero la conexión a Internet es lo suficientemente lenta como para no subirlo en 30 segundos, no se subirá porque excedió el tiempo de espera.
Si el canal de comunicación es WhatsApp, tiene sus propias reglas. Estas son:
Tipos de contenido compatibles
Medios | Tipos de contenido compatibles |
|
Observación: El tipo de base audio/ogg no es compatible. |
| Qualquer tipo MIME válido. |
|
Actualmente, las imágenes con fondo transparente no son compatibles. |
|
|
|
Observaciones: Solo son compatibles el códec de vídeo H.264 y el códec de audio AAC. Aceptamos vídeos con flujo de audio único o sin flujo de audio. |
Tamaño del medio después del procesamiento
Este es el tamaño máximo permitido después de que el archivo de medios se haya comprimido y encriptado.
Tipo de mídia | Tamanho |
| 16 MB |
| 100 MB |
| 5 MB |
| 100 KB |
| 16 MB |
Los medios enviados a través de mensajes se almacenan en los servidores de WhatsApp durante 14 días. Si un usuario solicita descargar el medio después de este período, los servidores de WhatsApp solicitarán el mismo archivo de medios del cliente local de WhatsApp Business. Si el medio ha sido eliminado, el usuario será notificado de que no está disponible.
No es seguro asumir que la descarga se ha completado solo en base a los recibos de entrega y lectura. En general, los medios salientes pueden eliminarse después de 30 días, pero utilice la estrategia que mejor se adapte a su empresa.
Restricciones
- Si utiliza el proceso de carga de medios en lugar de un enlace a la URL del medio en cuestión, el archivo deberá cargarse en el volumen de medios. Una vez completada la carga, envíe un mensaje utilizando el ID del medio.
- La aplicación procesa los medios cargados antes de enviarlos al servidor. El tamaño máximo de los medios que se pueden cargar en el nodo de medios es de 100 MB. Sin embargo, existen límites después del procesamiento para los diferentes tipos de medios descritos en la tabla de Tamaño de medio después del procesamiento anterior.
- El almacenamiento de medios debe ser gestionado por la empresa. Si el volumen de medios alcanza el límite, comenzará a fallar el envío de mensajes.
- No se admiten las siguientes acciones:
Envío de medios por secuencias de bytes.
Envío de mensajes con stickers animados.
Cómo cargar
Realice una solicitud POST a /v1/media para cargar el medio. El cuerpo de la solicitud local debe contener los datos de medios binarios, y el encabezado Content-Type debe establecerse según el tipo de medios cargados.
Enviar los datos binarios en una solicitud POST HTTP es el método estándar para cargar datos binarios. Por ejemplo, si desea cargar una imagen, envíe una solicitud POST con los bytes reales de la imagen en la carga. Otra opción es usar --data-binary si desea que cURL lea y use el archivo proporcionado en binarios exactamente como está.
Ejemplo
Carga de medios:
POST /v1/media
Content-Type:
Carga de medios con cURL:
curl -X POST \
https://:/v1/media \
-H 'Authorization: Bearer ' \
-H 'Content-Type: image/jpeg' \ # or other appropriate media type
--data-binary @
En ambos casos, una respuesta exitosa devolverá el campo id, necesario para recuperar medios o enviar mensajes de medios a los clientes.
{
"media": [
{
"id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
}
]
}Si recibe un mensaje de error, consulte Mensajes de error y estado para obtener más información.
Puede encontrar más información sobre estas en la página oficial de META
