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

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

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

첨부 파일 업로드

첨부 파일을 업로드하려면 /Your-page-id/message_attachment 엔드포인트로 POST 요청을 보내세요. 이때 type과 payload를 포함한 message.attachment를 포함합니다. 여러 메시지에서 자산을 사용하려면 payload.is_reusable을 true로 설정하세요.

URL에서 업로드하기 위한 요청의 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글씨, 기울임꼴 값(예: page_access_token)을 자신의 값으로 바꿉니다.

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

파일에서 업로드하기 위한 요청의 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글씨, 기울임꼴 값(예: page_access_token)을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/Your-page-id/message_attachment" \
     -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"
         }'

요청에 성공하면 앱이 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 "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":{
                 "attachment_id":"Your-attachment-ID"
               }
             }
           }
         }'

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

{"success": "true"}

속성

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

message

message.attachment

message.attachment.payload

오류 코드