ข้อมูลอ้างอิงเกี่ยวกับ 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/v20.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 "https://graph.facebook.com/v20.0/Your-page-id/message_attachments" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image"
             }
           },
           "filedata":"@/path-to-your-file/image.png";"type":"image/png"
         }'

เมื่อดำเนินการสำเร็จ คุณจะได้รับอ็อบเจ็กต์ 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 "https://graph.facebook.com/v20.0/Your-page-id/messages" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image",
               "payload":{
                 "attachment_id":"Your-attachment-ID"
               }
             }
           }
         }'

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

{"success": "true"}

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

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

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

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

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

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

{"success": "true"}

คุณสมบัติ

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

message

message.attachment

message.attachment.payload

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