Contenido multimedia

/v1/media

Utiliza el nodo media para subir, recuperar o eliminar contenido multimedia.

Perímetros

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

Antes de empezar

Cuando se envía un mensaje multimedia, el contenido multimedia se almacena en los servidores de WhatsApp durante 14 días. Si un usuario realiza una solicitud para descargar el contenido multimedia después de 14 días, los servidores de WhatsApp solicitarán el mismo archivo multimedia al cliente local de WhatsApp Business. Si el contenido multimedia se ha eliminado, se enviará una notificación al usuario para indicarle que no está disponible.

No se puede suponer que el contenido multimedia se ha descargado solamente con los recibos de confirmación de entrega y lectura. Normalmente, el contenido multimedia saliente se puede eliminar con seguridad después de 30 días, pero debes emplear una estrategia adecuada para tu empresa.

Restricciones

• Si utilizas el proceso de subida de contenido multimedia en vez de incluir un enlace a una URL de contenido multimedia, el archivo se debe subir al volumen del contenido multimedia. Una vez subido, puedes enviar un mensaje mediante el identificador del contenido multimedia.
• La aplicación procesa el contenido multimedia que se sube antes de que se envíe al servidor. Aunque el tamaño máximo de los archivos multimedia que se pueden subir al nodo media es de 100 MB, existen límites de posprocesamiento para los distintos tipos de contenido multimedia, tal y como se indica en la tabla de tamaño del contenido multimedia de posprocesamiento que hay a continuación.
• El almacenamiento de contenido multimedia debe gestionarlo la empresa. Si el volumen multimedia está lleno, el envío de mensajes empezará a generar errores.
• No se admiten las acciones siguientes:

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

Subida

Haz una solicitud POST a /v1/media para subir el contenido multimedia. El cuerpo de la solicitud local debe contener los datos multimedia binarios, y el encabezado Content-Type debe estar establecido en el tipo de contenido multimedia que se sube. Consulta la sección Tipos de contenido admitidos para ver las opciones compatibles.

El envío de datos binarios en una solicitud POST HTTP es una forma estándar de subir datos binarios. Por ejemplo, si quieres subir una imagen, debes emitir una solicitud POST con los bytes de imagen reales en la carga útil. También puedes utilizar --data-binary si quieres que cURL lea y utilice el archivo determinado en el formato binario, tal y como se proporciona.

Ejemplo

Subida de contenido multimedia:

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

your-binary-media-data

Subida de contenido 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 correcta, se devuelve el campo id, que necesitas para recuperar el contenido multimedia o enviar un mensaje multimedia a tus clientes.

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

Si recibes un mensaje de error, consulta Mensajes de error y de estado para obtener más información.

Tipos de contenido admitidos

Tamaño del contenido multimedia de posprocesamiento

Este es el tamaño máximo permitido del archivo 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