Identificador de contenido multimedia

/v1/media/{media-id}

Dado tu identificador específico, usa este punto de conexión para recuperar o eliminar tu contenido multimedia.

Antes de empezar

Antes de recuperar el archivo eliminado, primero debes subir el contenido multimedia mediante /v1/media.

Consulta

Una vez que hayas subido correctamente el contenido multimedia, recibirás una respuesta con el identificador de contenido multimedia. Usa ese identificador en cualquier solicitud para recuperar los archivos multimedia almacenados en el cliente de la API de WhatsApp Business.

Este proceso para recuperar los archivos multimedia también se utiliza cuando un usuario te envía una imagen que recibe tu webhook. Cuando se reciba un mensaje con contenido multimedia, el cliente de la API de WhatsApp Business descargará el contenido. Una vez que se descargue el contenido multimedia, tu webhook te enviará una notificación. Utiliza el identificador del contenido multimedia que se encuentra en dicha notificación para recuperar el contenido multimedia.

Puedes activar el cliente de la API de WhatsApp Business para que descargue automáticamente los archivos multimedia mediante la configuración de descarga automática de archivos multimedia.

Ejemplo:

GET /v1/media/media-id

Por ejemplo, tomemos la imagen de ejemplo que se subió 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 aparece más adelante:

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 procesa correctamente, verás el estado 200 OK y los datos binarios del archivo multimedia.

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

binary-media-data

Si usaste una herramienta como Postman, verás la imagen. Si usas una herramienta de línea de comandos, verás los datos binarios. Si enviaste los datos a un archivo, verás la imagen en el explorador de archivos.

Si no se encuentran archivos multimedia, se devolverá un código de respuesta 404 Not Found sin cuerpo.

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

Eliminación

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

Ejemplo:

Solicitud:

DELETE /v1/media/media-id

Si la respuesta es satisfactoria, se verá 200 OK y null o {}. Si no se encuentra el archivo multimedia, la respuesta mostrará 404 Not Found y no tendrá cuerpo. En caso de que ocurra otro error, consulta los mensajes de error y de estado para obtener más información.