Справка по Attachment Upload API

Attachment Upload API позволяет загружать объекты, которые позднее можно отправлять в сообщениях. Благодаря этому вам не нужно загружать часто используемые файлы несколько раз. Этот API поддерживает сохранение объектов из URL и из локальной файловой системы.

Кроме того, можно использовать Send API, чтобы одновременно отправлять сообщение с вложением и сохранять вложения для использования в будущем. Дополнительную информацию см. в разделе Загрузка и отправка ниже.

Загрузка вложения

Чтобы загрузить вложение, отправьте запрос POST к конечной точке /Your-page-id/message_attachments и укажите message.attachment и свойства type и payload. Чтобы этот объект можно было использовать в нескольких сообщениях, задайте для свойства 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}"

В случае успеха приложение получит объект JSON с идентификатором attachment_id, которому назначено ID вашего вложения, чтобы использовать его в ваших сообщениях.

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

В случае успеха приложение получит объект JSON, в котором для параметра success установлено значение true.

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

В случае успеха приложение получит объект JSON, в котором для параметра success установлено значение true.

{"success": "true"}

Свойства

Для вложений из URL предоставьте свойства follow в основном тексте запроса в качестве объекта JSON. Для вложений из файла отправьте свойства как данные формы.

message

message.attachment

message.attachment.payload

Коды ошибок