Identificador de contenido multimedia

/v1/media/{media-id}

A partir de un identificador específico, usa este extremo para recuperar o eliminar el contenido multimedia.

Antes de empezar

Antes de recuperar la eliminación, primero debes subir el contenido multimedia mediante /v1/media.

Recuperación

Una vez subido correctamente el contenido multimedia, recibes una respuesta que contiene el identificador de dicho contenido. Usa este identificador en las solicitudes de recuperación del contenido multimedia almacenado en el cliente de la API de WhatsApp Business.

Este proceso de recuperación de contenido multimedia también se utiliza cuando un usuario te envía una imagen que recibe tu webhook. Cuando se recibe un mensaje con contenido multimedia, el cliente de la API de WhatsApp Business descarga dicho contenido. Una vez descargado, recibirás una notificación a través del webhook. Usa el identificador del contenido multimedia incluido en la notificación para recuperar el contenido.

Puedes activar la descarga automática de contenido multimedia en el cliente de la API de WhatsApp Business con la configuración de la descarga automática de contenido multimedia.

Ejemplo

GET /v1/media/media-id

Por ejemplo, con la imagen de ejemplo subida en la sección anterior:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

Para enviar este contenido multimedia de ejemplo a un archivo, usa el parámetro -o, como se muestra a continuación:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

Si la llamada se realiza correctamente, obtienes una respuesta que contiene un estado 200 OK y los datos binarios del contenido multimedia.

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

Si has utilizado una herramienta como Postman, ves la imagen. Si usas una herramienta de línea de comandos, ves los datos binarios. Si has enviado los datos a un archivo, ves la imagen en el navegador de archivos.

Si no se encuentra el contenido multimedia, se devuelve un código de respuesta 404 Not Found sin ningún cuerpo.

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

Eliminación

Para eliminar contenido multimedia en el cliente de la API de WhatsApp Business, envía una solicitud DELETE al nodo media junto con el identificador del contenido multimedia que quieras eliminar. Usa el identificador de la respuesta para subir el contenido multimedia o el mensaje multimedia desde un webhook.

Ejemplo

Solicitud:

DELETE /v1/media/media-id

Una respuesta correcta muestra 200 OK y null o {}. Si no se encuentra el contenido multimedia, la respuesta muestra 404 Not Found y no contiene ningún cuerpo. Si recibes un mensaje de error diferente, consulta Mensajes de error y de estado para obtener más información.