Платформа Messenger

API User Profile

API User Profile позволяет получать информацию о профиле пользователя с помощью идентификатора с областью действия Instagram (IGSID). Эту информацию можно использовать для создания персонализированного контента для людей, взаимодействующих с вашей компанией.

Согласие пользователей

Для доступа к профилю пользователя обязательно требуется согласие пользователя. Согласие пользователя гарантируется только тогда, когда пользователь отправляет компании сообщение либо нажимает вводную фразу или элемент постоянного меню. Если человек комментирует публикацию или отвечает на комментарий, но не отправляет сообщение компании, ваше приложение получит ошибку: Для доступа к профилю пользователя требуется согласие пользователя.

Требования

Вам понадобятся:

  • разрешение instagram_basic;
  • разрешение instagram_manage_messages;
  • разрешение pages_manage_metadata;
  • разрешение pages_read_engagement;
  • разрешение pages_show_list.
  • маркер доступа к Странице, запрошенный пользователем, который может выполнять действие MODERATE на Странице.

Ограничения

Если пользователь заблокировал вашу компанию, вы не сможете посмотреть информацию о нем.

Поля профиля пользователя

Перечисленные ниже поля профиля доступны для всех версий API Graph.

Имя поля Описание

name

Строка

Имя пользователя (может быть пустым, если имя не задано).

profile_pic

URL

URL фото профиля пользователя (может быть пустым, если изображение не задано). Срок действия этого URL составляет несколько дней.

Перечисленные ниже поля профиля доступны для API Graph версии 12.0 и более поздних.

Имя поля Описание

is_verified_user

Логическое значение

Статус подтверждения пользователя.

follower_count

Целое число

Количество подписчиков пользователя.

is_user_follow_business

Логическое значение

Указывает, подписан ли пользователь на компанию.

is_business_follow_user

Логическое значение

Указывает, подписана ли компания на пользователя.

Перечисленные ниже поля доступны для API Graph версии 14.0 и более поздних.

ПолеОписание

username

Строка

Имя пользователя в Instagram.

Примеры

Чтобы получить информацию о профиле пользователя, отправьте запрос GET к узлу идентификатора пользователя с областью действия Instagram и укажите в нем нужные поля.

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

Для удобства чтения применено форматирование.
curl -X GET "https://graph.facebook.com/v19.0/instagram-scoped-user-id
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=page-access-token"

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

{
  "name": "Peter Chang",
  "username": "peter_chang_live",
  "profile_pic": "https://fbcdn-profile-...",
  "follower_count": 1234
  "is_user_follow_business": false,
  "is_business_follow_user": true,
}

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