첨부 파일 업로드 API 참고 자료

첨부 파일 업로드 API를 사용하면 자산을 업로드하여 나중에 이를 메시지에서 전송하도록 할 수 있습니다. 그러면 자주 사용하는 파일을 여러 번 업로드하지 않아도 됩니다. 이 API는 URL과 로컬 파일 시스템의 자산을 저장하도록 지원합니다.

Send API를 사용하여 첨부 파일과 함께 메시지를 동시에 전송하고 나중에 사용하기 위해 첨부 파일을 저장할 수도 있습니다. 자세한 내용은 아래의 업로드 및 보내기 섹션을 참조하세요.

첨부 파일 업로드

첨부 파일을 업로드하려면 /Your-page-id/message_attachments 엔드포인트로 POST 요청을 보내세요. 이때 type과 payload를 포함한 message.attachment를 포함합니다. 여러 메시지에서 자산을 사용하려면 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}"

요청에 성공하면 앱이 attachment_id가 메시지에서 사용할 첨부 파일의 ID로 설정된 JSON 개체를 받습니다.

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

업로드한 자산을 포함하여 메시지 보내기

이전에 업로드한 자산을 포함하여 메시지를 보내려면 message.attachment.payload.is_reusable을 true로 설정하여 자산을 업로드하고, /Your-page-id/messages 엔드포인트로 POST 요청을 보냅니다. 이때 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}"

요청에 성공하면 앱이 success가 true로 설정된 JSON 개체를 받게 됩니다.

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

요청에 성공하면 앱이 success가 true로 설정된 JSON 개체를 받게 됩니다.

{"success": "true"}

속성

URL의 첨부 파일에 대해서는 요청 본문에 다음 속성을 JSON 개체로 제공합니다. 파일의 첨부 파일에 대해서는 속성을 양식 데이터로 전송합니다.

message

message.attachment

message.attachment.payload

오류 코드