添付ファイルアップロードAPIのリファレンス

添付ファイルアップロードAPIを使用してアセットをアップロードすれば、後からそれをメッセージで送信できます。これにより、よく使用するファイルを何度もアップロードする必要がなくなります。このAPIは、URLのアセットの保存とローカルファイルシステムのアセットの保存をサポートしています。

Send APIを使用して、添付ファイル付きのメッセージの送信と、後から使うための添付ファイルの保存を同時に行うこともできます。詳細については、以下の アップロードして送信のセクションをご覧ください。

添付ファイルをアップロードする

添付ファイルをアップロードするには、typeにpayloadとmessage.attachmentを指定したPOSTリクエストを、/Your-page-id/message_attachmentsエンドポイントに送信してください。複数のメッセージでアセットを使用するには、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}"

成功すると、メッセージで使用する添付ファイルのIDに設定されたattachment_idのJSONオブジェクトがアプリに送信されます。

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

アップロード済みのアセットを付けてメッセージを送信する

過去にアップロードしたアセット(message.attachment.payload.is_reusableをtrueに設定してアップロードされたもの)を付けてメッセージを送信するには、POSTリクエストをrecipient.idを指定して/Your-page-id/messagesに、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}"

成功すると、アプリはsuccessがtrueに設定されたJSONオブジェクトを受け取ります。

{"success": "true"}

アップロードして送信

1回の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}"

成功すると、アプリはsuccessがtrueに設定されたJSONオブジェクトを受け取ります。

{"success": "true"}

プロパティ

URLから添付する場合は、リクエスト本文に次のプロパティをJSONオブジェクトとして指定します。ファイルからの添付の場合は、プロパティをフォームデータとして送信します。

message

message.attachment

message.attachment.payload

エラーコード