Tài liệu tham khảo về API Tải lên file đính kèm

API Tải lên file đính kèm cho phép bạn tải lên tài sản có thể gửi trong tin nhắn sau đó. Nhờ vậy, bạn không phải tải lên nhiều lần các file thường dùng. API này hỗ trợ lưu tài sản từ URL và từ hệ thống file cục bộ của bạn.

Bạn cũng có thể dùng Send API để gửi đồng thời tin nhắn có file đính kèm và lưu file đính kèm đó để sử dụng sau. Để biết thêm thông tin, hãy xem phần Tải lên và gửi bên dưới.

Tải file đính kèm lên

Để tải file đính kèm lên, hãy gửi yêu cầu POST đến điểm cuối /Your-page-id/message_attachments, kèm theo message.attachment có type và payload. Để có thể sử dụng tài sản này trong nhiều tin nhắn, hãy đặt payload.is_reusable là true.

Yêu cầu mẫu cho trường hợp tải lên từ URL

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như page_access_token bằng các giá trị của bạn.

curl -X POST "https://graph.facebook.com/v21.0/Your-page-id/message_attachments" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image", 
               "payload":{
                 "url":"https://your-url.com/image.jpg",
                 "is_reusable": true
               }
             }
           }
         }'

Yêu cầu mẫu cho trường hợp tải lên từ file

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như page_access_token bằng các giá trị của bạn.

curl -X POST -H "Content-Type: application/json" -d '{
   "message": {
     "attachment": {
       "type": "image"
     }
   },
   "filedata": "@/path-to-your-file/image.jpg",
   "type": "image/png"
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/message_attachments?access_token={PAGE_ACCESS_TOKEN}"

Khi thành công, ứng dụng của bạn sẽ nhận được một đối tượng JSON có attachment_id được đặt là ID của file đính kèm mà bạn sẽ dùng trong tin nhắn.

{"attachment_id": "Your-attachment-ID"}

Gửi tin nhắn có chứa tài sản đã tải lên

Để gửi tin nhắn có chứa tài sản mà bạn đã tải lên trước đó với message.attachment.payload.is_reusable được đặt là true, hãy gửi yêu cầu POST đến điểm cuối /Your-page-id/messages kèm theo recipient.id cùng đối tượng message.attachment có type và payload.attachment_id.

Yêu cầu mẫu cho trường hợp tải lên từ file

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như page_access_token bằng các giá trị của bạn.

curl -X POST -H "Content-Type: application/json" -d '{
    "recipient": {
      "id": "{PSID}"
    },
    "message": {
      "attachment": {
        "type": "image",
        "payload": {
          "attachment_id": "Your-attachment-ID"
        }
      }
    }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

Khi thành công, ứng dụng của bạn sẽ nhận được một đối tượng JSON có success được đặt là true.

{"success": "true"}

Tải lên và gửi

Ngoài ra, bạn có thể tải lên và gửi file phương tiện trong một yêu cầu API duy nhất.

Yêu cầu mẫu cho trường hợp tải lên từ URL

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như page_access_token bằng các giá trị của bạn.

curl -X POST -H "Content-Type: application/json" -d '{
   "recipient": {
     "id": "{PSID}"
   },
   "message": {
     "attachment": {
       "type": "image",
       "payload": {
         "url": "https://your-url.com/image.jpg"
       }
     }
   }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

Khi thành công, ứng dụng của bạn sẽ nhận được một đối tượng JSON có success được đặt là true.

{"success": "true"}

Thuộc tính

Đối với file đính kèm từ URL, hãy cung cấp các thuộc tính sau trong phần nội dung của yêu cầu dưới dạng đối tượng JSON. Đối với file đính kèm từ file, hãy gửi thuộc tính dưới dạng dữ liệu mẫu.

message

message.attachment

message.attachment.payload

Mã lỗi