ID file phương tiện

/v1/media/{media-id}

Khi có ID cụ thể, hãy sử dụng điểm cuối này để truy xuất hoặc xóa file phương tiện của bạn.

Trước khi bạn bắt đầu

Trước khi truy xuất hoặc xóa, bạn phải tải file phương tiện của mình lên qua /v1/media.

Truy xuất

Sau khi tải file phương tiện lên thành công, bạn sẽ nhận được phản hồi có chứa ID file phương tiện. Hãy sử dụng ID đó trong bất kỳ yêu cầu nào để truy xuất file phương tiện được lưu trữ trong ứng dụng API WhatsApp Business.

Bạn cũng có thể sử dụng quy trình này để truy xuất file phương tiện khi nhận được hình ảnh do người dùng gửi thông qua Webhook của bạn. Khi bạn nhận được tin nhắn có chứa file phương tiện, ứng dụng API WhatsApp Business sẽ tải file phương tiện đó xuống. Sau khi file phương tiện được tải xuống, bạn sẽ nhận được thông báo qua Webhook. Hãy sử dụng ID file phương tiện có trong thông báo đó để truy xuất file phương tiện.

Bạn có thể cho phép ứng dụng API WhatsApp Business tự động tải file phương tiện xuống qua phần Cài đặt tự động tải file phương tiện xuống.

Ví dụ

GET /v1/media/media-id

Ví dụ: sử dụng hình ảnh mẫu được tải lên ở phần trước:

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

Để gửi file phương tiện mẫu này đến một file, hãy sử dụng thông số -o như minh họa bên dưới:

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

Nếu lệnh gọi thành công, bạn sẽ thấy phản hồi có chứa trạng thái 200 OK và dữ liệu file phương tiện nhị phân.

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

binary-media-data

Nếu đã sử dụng công cụ như Postman, bạn sẽ thấy hình ảnh. Nếu đang sử dụng công cụ dòng lệnh, bạn sẽ thấy dữ liệu nhị phân. Nếu đã gửi dữ liệu đến một file, bạn sẽ thấy hình ảnh trong trình duyệt file của mình.

Nếu không tìm thấy file phương tiện, hệ thống sẽ trả về mã phản hồi 404 Not Found mà không có nội dung.

Nếu bạn nhận được thông báo lỗi khác, hãy xem bài viết Thông báo trạng thái và thông báo lỗi để biết thêm thông tin.

Xóa

Để xóa file phương tiện trong ứng dụng API WhatsApp Business, hãy gửi yêu cầu DELETE đến nút media cùng với ID của file phương tiện mà bạn muốn xóa. Hãy sử dụng ID trong phản hồi để tải lên file phương tiện hoặc tin nhắn có chứa file phương tiện từ Webhook.

Ví dụ

Yêu cầu:

DELETE /v1/media/media-id

Phản hồi thành công sẽ hiện 200 OK và null hoặc {}. Nếu không tìm thấy file phương tiện, phản hồi sẽ hiện 404 Not Found mà không có nội dung. Nếu bạn nhận được thông báo lỗi khác, hãy xem bài viết Thông báo trạng thái và thông báo lỗi để biết thêm thông tin.