附件上載 API 參考資料

附件上載 API 可讓您之後在訊息中上載素材，與訊息一起傳送。這樣您就不必多次上載常用的檔案。API 支援從網址和本機檔案系統儲存素材。

您亦可使用 Send API 傳送含有附件的訊息，同時儲存該附件以便日後使用。如需更多資訊，請參閱下面的上載和傳送區塊。

上載附件

若要上載附件，請向 /Your-page-id/message_attachments 端點傳送 POST 要求，其中的 message.attachment 需包含 type 和 payload。如需在多則訊息中使用素材，請將 payload.is_reusable 設為 true。

要求從網址上載的範例

已設定格式以便閱讀。使用自家值替換 bold、italics values，如 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
               }
             }
           }
         }'

要求從檔案上載的範例

已設定格式以便閱讀。使用自家值替換 bold、italics values，如 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 設為要在訊息中使用的附件編號。

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

傳送包含已上載素材的訊息

如要傳送包含您先前已經上載的素材的訊息，並且在上載時將 message.attachment.payload.is_reusable 設為 true，請向編號為 recipient.id 的 /Your-page-id/messages 端點傳送 POST 要求，其中的 message.attachment 物件包含 type 和 payload.attachment_id。

要求從檔案上載的範例

已設定格式以便閱讀。使用自家值替換 bold、italics values，如 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 要求傳送。

要求從網址上載的範例

已設定格式以便閱讀。使用自家值替換 bold、italics values，如 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"}

屬性

針對來自網址的附件，請以 JSON 物件格式傳送要求，並於要求內文中提供下列屬性。針對來自檔案的附件，請以表格資料形式傳送屬性。

message

message.attachment

message.attachment.payload

錯誤代碼