Платформа Messenger

Отправка сообщений

В этом документе перечислены требования к отправке сообщений в свободной форме из профессионального аккаунта Instagram клиентам и заинтересованным людям с использованием платформы Messenger from Meta.

Вы можете отправлять сообщения в свободной форме, которые содержат:

  • изображения, gif, видео или аудио;
  • реакции и стикеры;
  • текст, включая ссылки.

Прежде чем начать

Предполагается, что вы уже ознакомились с обзором платформы Messenger и реализовали необходимые компоненты, такие как Страница Facebook, связанная с вашим профессиональным аккаунтом Instagram (или тестовая Страница), а также зарегистрировались в качестве разработчика Meta и создали ID приложения для бизнеса в разделе Messenger > "Продукт для обмена сообщениями в Instagram" на панели приложений.

Вы также можете проверить статус платформы разработчиков Meta , чтобы убедиться в отсутствии проблем.

Требования

  • ID Страницы Facebook, связанной с вашим профессиональным аккаунтом Instagram.
  • Идентификатор с областью действия Instagram для клиента, который отправил сообщение вашей компании.
  • Маркер доступа к Странице, запрошенный от имени пользователя, который может выполнять задачу MESSAGE на Странице Facebook, связанной с вашим профессиональным аккаунтом Instagram.
  • Разрешение instagram_manage_messages.

Ограничения

  • Приложения со стандартным уровнем доступа могут отправлять сообщения только тем пользователям, у которых есть роль в этих приложениях.
  • Допустимые прикрепленные медиафайлы:
Тип медиафайлаПоддерживаемый форматМаксимальный поддерживаемый размер

Аудио

acc, m4a, wav, mp4

25 МБ

Изображение

png, jpeg, gif

8 МБ

Видео

mp4, ogg, avi, mov, webm

25 МБ

Дополнительную информацию о прикрепленных медиафайлах см. в статье Загрузка медиафайлов для обмена сообщениями в Instagram.

Отправка стандартных сообщений

Чтобы отправить сообщение, которое содержит текст или ссылку, отправьте запрос POST к конечной точке /PAGE-ID/messages и укажите в параметре recipient идентификатор с областью действия Instagram (IGSID), а в параметре message — текст или ссылку.

Текст сообщения должен иметь формат UTF-8 и не превышать 1000 байт. Ссылки должны быть действительными и иметь формат URL.

Пример запроса

Для удобства чтения применено форматирование.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

Пример ответа API

В случае успеха приложение получит следующий ответ в формате JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Отправка публикации

Чтобы отправить сообщение, содержащее публикацию в Instagram, отправьте запрос POST к конечной точке /PAGE-ID/messages с параметром recipient, содержащим идентификатор с областью действия Instagram (IGSID), и с параметром message, содержащим объект attachment, в котором для type установлено MEDIA_SHARE, а также payload, содержащим ID Meta для публикации.

Ваша компания должна быть владельцем медиафайла, который используется в сообщении.

Пример запроса

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

Пример ответа API

В случае успеха приложение получит следующий ответ в формате JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Отправка стикера

Чтобы отправить стикер с изображением сердца, отправьте запрос POST к конечной точке /PAGE-ID/messages, указав в параметре recipient идентификатор с областью действия Instagram (IGSID), а в параметре message — объект attachment, в котором для type установлено значение like_heart.

Пример запроса

Для удобства чтения применено форматирование.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

Пример ответа API

В случае успеха приложение получит следующий ответ в формате JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Реакция на сообщение

Чтобы отправить реакцию, отправьте запрос POST к конечной точке /PAGE-ID/messages, указав в параметре recipient идентификатор с областью действия Instagram (IGSID), а в параметре sender_action — значение react, где в payload в качестве message_id указан ID сообщения, к которому необходимо применить реакцию, а в reaction задано love.

Пример запроса

Для удобства чтения применено форматирование.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

Чтобы удалить реакцию из сообщения, отправьте запрос POST к конечной точке /PAGE-ID/messages, указав в параметре recipient идентификатор с областью действия Instagram (IGSID), а в параметре sender_action — значение unreact, где в payload в качестве message_id указан ID сообщения, из которого необходимо удалить реакцию.

Пример запроса

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

Пример ответа

В случае успеха ваше приложение получит следующий ответ в формате JSON для запросов о добавлении и удалении реакции:

{
  "recipient_id": "IGSID"
}

Дальнейшие действия

См. также

Поддержка разработчиков