ข้อมูลอ้างอิงเกี่ยวกับ API การอัพโหลดไฟล์แนบ

API การอัพโหลดไฟล์แนบช่วยให้คุณสามารถอัพโหลดองค์ประกอบต่างๆ ที่คุณสามารถส่งไปกับข้อความในภายหลังได้ ซึ่งช่วยให้คุณไม่จำเป็นต้องอัพโหลดไฟล์ที่ใช้บ่อยหลายๆ ครั้ง API นี้รองรับการบันทึกองค์ประกอบต่างๆ จาก URL และจากระบบไฟล์ในเครื่องของคุณ

นอกจากนี้ คุณสามารถใช้ API การส่งเพื่อส่งข้อความพร้อมไฟล์แนบและบันทึกไฟล์แนบไว้ใช้ในภายหลังไปพร้อมๆ กันได้ โปรดดูข้อมูลเพิ่มเติมในส่วนอัพโหลดและส่งที่ด้านล่าง

อัพโหลดไฟล์แนบ

หากต้องการอัพโหลดไฟล์แนบ ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /Your-page-id/message_attachments พร้อมด้วย message.attachment ที่มี type และ payload ตั้งค่า payload.is_reusable เป็น true เพื่อให้สามารถใช้องค์ประกอบในหลายข้อความ

ตัวอย่างคำขออัพโหลดจาก URL

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและตัวเอียง เช่น page_access_token ด้วยค่าของคุณ

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
               }
             }
           }
         }'

ตัวอย่างคำขออัพโหลดจากไฟล์

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและตัวเอียง เช่น page_access_token ด้วยค่าของคุณ

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}"

เมื่อดำเนินการสำเร็จ คุณจะได้รับอ็อบเจ็กต์ JSON ที่มี attachment_id ซึ่งตั้งค่าเป็น ID ของไฟล์แนบที่จะใช้ในข้อความของคุณ

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

ส่งข้อความพร้อมองค์ประกอบที่อัพโหลด

หากต้องการส่งข้อความที่มีองค์ประกอบที่คุณอัพโหลดก่อนหน้านี้ ให้อัพโหลดโดยตั้งค่า message.attachment.payload.is_reusable เป็น true จากนั้นส่งคำขอ POST ไปยังตำแหน่งข้อมูล /Your-page-id/messages พร้อมด้วย recipient.id และอ็อบเจ็กต์ message.attachment พร้อมด้วย type และ payload.attachment_id

ตัวอย่างคำขออัพโหลดจากไฟล์

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและตัวเอียง เช่น page_access_token ด้วยค่าของคุณ

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}"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับอ็อบเจ็กต์ JSON ที่มี success ซึ่งตั้งค่าเป็น true

{"success": "true"}

อัพโหลดและส่ง

คุณสามารถอัพโหลดและส่งสื่อในคำขอ API เดียวกันได้ด้วย

ตัวอย่างคำขออัพโหลดจาก URL

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย แทนที่ค่าที่เป็นตัวหนาและตัวเอียง เช่น page_access_token ด้วยค่าของคุณ

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}"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับอ็อบเจ็กต์ JSON ที่มี success ซึ่งตั้งค่าเป็น true

{"success": "true"}

คุณสมบัติ

ในกรณีของไฟล์แนบจาก URL ให้ระบุคุณสมบัติต่อไปนี้ในเนื้อความของคำขอในรูปแบบอ็อบเจ็กต์ JSON ส่วนไฟล์แนบจากไฟล์นั้น ให้ส่งคุณสมบัติต่างๆ ในรูปแบบข้อมูลแบบฟอร์ม

message

message.attachment

message.attachment.payload

รหัสข้อผิดพลาด