Contenido multimedia

/v1/media

Usa el nodo media para subir, recuperar o eliminar archivos multimedia.

Perímetros

Los siguientes perímetros están conectados a este nodo:

Antes de empezar

Cuando se envía un mensaje de contenido multimedia, se almacena en los servidores de WhatsApp durante 14 días. Si un usuario solicita descargar el contenido multimedia luego de 14 días, los servidores de WhatsApp solicitarán dicho contenido al cliente de instalaciones locales de WhatsApp Business. Si el contenido multimedia se eliminó, se notificará al usuario que dicho contenido no se encuentra disponible.

No hay que dar por sentado que los archivos multimedia se descargaron simplemente porque se recibieron confirmaciones de entrega y lectura. En el caso de los archivos multimedia salientes, por lo general, resulta seguro eliminarlos luego de 30 días, pero utiliza la estrategia que mejor se adecúe a tu empresa.

Restricciones

• Si utilizas el proceso de carga de contenido multimedia en vez de incluir un enlace a una URL de un archivo multimedia, el archivo debe subirse al volumen de contenido multimedia. Una vez que se completa la carga, puedes enviar un mensaje con el identificador de archivos multimedia.
• Nota: La app procesa los archivos multimedia que se suben antes de que se envíen al servidor. Si bien el tamaño máximo de archivos multimedia que se pueden subir al nodo media es de 100 MB, existen límites de posprocesamiento para los distintos tipos de archivos multimedia. Puedes consultar dichos límites en la tabla de tamaño de archivos multimedia de posprocesamiento.
• La administración del almacenamiento de archivos multimedia se encuentra a cargo de la propia empresa. Si el volumen de archivos multimedia se llena, el envío de mensajes comenzará a fallar.
• No se admiten las siguientes funciones:

  • Enviar contenido multimedia por flujos de bytes.
  • Enviar mensajes con stickers animados.

Carga

Haz una solicitud POST a /v1/media para cargar tu contenido multimedia. El cuerpo de la solicitud de instalaciones locales debe contener datos de archivos multimedia binarios y el encabezado Content-Type debe estar configurado en el tipo de archivo multimedia que se está cargando. Consulta la sección sobre tipos de contenido admitidos para conocer las opciones disponibles.

Enviar datos binarios en una solicitud POST HTTP es un método estándar para subir datos binarios. Por ejemplo, si quieres subir una imagen, envía una solicitud POST con los bytes de la imagen en la carga. También puedes usar cURL si quieres que --data-binary lea y use el archivo específico en formato binario, tal como se proporciona.

Ejemplo:

Subir archivos multimedia:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

Subir archivos multimedia con cURL:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

En ambos casos, si la respuesta es satisfactoria, se devolverá el campo id, que necesitas para recuperar contenido multimedia o enviar mensajes con archivos a tus clientes.

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

En caso de que ocurra un error, consulta Mensajes de error y de estado para obtener más información.

Tipos de contenido admitidos

Tamaño de archivos multimedia de posprocesamiento

Este es el tamaño máximo permitido para los archivos multimedia después de la compresión y el cifrado.

Preguntas frecuentes

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

Más información

• Prácticas recomendadas
• Mensajes
• Referencia