附件上传 API 参考文档

使用附件上传 API，可以上传以后可通过消息发送的资产。这样，可避免多次上传常用文件。此 API 支持从网址和本地文件系统中保存资产。

此外，还可使用 Send API 同时发送带附件的消息和保存附件，以供日后使用。详情请参阅下方上传并发送部分。

上传附件

如要上传附件，请向 /Your-page-id/message_attachments 端点发送 POST 请求，并在请求中加入包含 type 和 payload 的 message.attachment。如要在多条消息中使用此资产，请将 payload.is_reusable 设为 true。

上传来自网址的附件的请求示例

为方便阅读，示例格式已经过调整。将粗体、斜体值（如 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，而且该参数已设为要在消息中使用的附件的编号。

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

发送包含已上传资产的消息

如要发送包含之前已上传的资产（上传时将 message.attachment.payload.is_reusable 设为 true）的消息，请向 /Your-page-id/messages 端点发送 POST 请求，并在请求中加入 recipient.id 以及包含 type 和 payload.attachment_id 的 message.attachment 对象。

上传来自文件的附件的请求示例

为方便阅读，示例格式已经过调整。将粗体、斜体值（如 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 请求中上传并发送素材。

上传来自网址的附件的请求示例

为方便阅读，示例格式已经过调整。将粗体、斜体值（如 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

错误代码