File phương tiện

/v1/media

Sử dụng nút media để tải lên, truy xuất hoặc xóa file phương tiện.

Cạnh

Dưới đây là những cạnh được kết nối với nút này:

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

Khi bạn gửi một tin nhắn có file phương tiện, file phương tiện đó sẽ được lưu trữ trên máy chủ WhatsApp trong 14 ngày. Nếu người dùng gửi yêu cầu tải file phương tiện xuống sau 14 ngày, máy chủ WhatsApp sẽ yêu cầu ứng dụng WhatsApp Business tại chỗ cung cấp chính file phương tiện đó. Nếu file phương tiện đã bị gỡ, người dùng sẽ nhận được thông báo rằng file phương tiện này không tồn tại.

Thật không an toàn khi cho rằng file phương tiện đã được tải xuống chỉ dựa trên thông báo đã gửi và đã đọc. Thông thường, bạn có thể gỡ file phương tiện gửi đi sau 30 ngày. Tuy nhiên, bạn nên triển khai chiến lược phù hợp nhất với doanh nghiệp của mình.

Giới hạn

• Nếu sử dụng quy trình tải file phương tiện lên thay vì liên kết đến URL file phương tiện, bạn phải tải file lên ổ đĩa file phương tiện. Sau khi quá trình tải lên hoàn tất, bạn có thể gửi tin nhắn bằng ID file phương tiện.
• Ứng dụng sẽ xử lý file phương tiện được tải lên rồi mới gửi file đó đến máy chủ. Mặc dù kích thước file phương tiện tối đa mà bạn có thể tải lên nút media là 100MB, nhưng các loại file phương tiện khác nhau sẽ có những giới hạn sau khi xử lý như nêu trong bảng Kích thước file phương tiện sau khi xử lý ở bên dưới.
• Doanh nghiệp cần xử lý bộ nhớ file phương tiện. Nếu ổ đĩa file phương tiện đầy, quy trình gửi tin nhắn sẽ bắt đầu bị lỗi.
• Chúng tôi chưa hỗ trợ:

  • Gửi file phương tiện theo luồng byte.
  • Gửi tin nhắn có nhãn dán động.

Tải lên

Gửi yêu cầu POST đến /v1/media để tải file phương tiện của bạn lên. Bạn phải thêm dữ liệu nhị phân của file phương tiện này vào phần nội dung của yêu cầu tại chỗ và đặt tiêu đề Content-Type thành loại file phương tiện mà bạn đang tải lên. Hãy xem phần Loại nội dung được hỗ trợ để biết các tùy chọn được hỗ trợ.

Cách tiêu chuẩn để tải dữ liệu nhị phân lên là gửi loại dữ liệu này trong yêu cầu POST HTTP. Ví dụ: nếu bạn muốn tải một hình ảnh lên, hãy gửi yêu cầu POST cùng với số byte thực tế của hình ảnh đó trong phần tải dữ liệu. Ngoài ra, bạn có thể sử dụng --data-binary nếu muốn cURL đọc và dùng chính file ở dạng nhị phân đã cung cấp.

Ví dụ

Tải file phương tiện lên:

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

your-binary-media-data

Tải file phương tiện lên thông qua 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

Trong cả hai trường hợp, phản hồi thành công sẽ trả về trường id. Bạn cần trường này để truy xuất file phương tiện hoặc gửi tin nhắn có file phương tiện cho khách hàng của mình.

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

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

Loại nội dung được hỗ trợ

Kích thước file phương tiện sau khi xử lý

Đây là kích thước tối đa cho phép của file phương tiện sau khi nén và mã hóa.

Câu hỏi thường gặp

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/

Tìm hiểu thêm

• Cách làm tốt nhất
• Tin nhắn
• Tài liệu tham khảo