Messenger Profile API

В профиле Messenger для Страницы можно задать свойства, от которых зависят различные аспекты перечисленных ниже функций платформы Messenger. Подробнее см. в таблице свойств профиля Messenger ниже.

• Кнопка "Начать"
• Страница приветствия
• Вводные фразы
• Постоянное меню
• Белый список доменов
• Связывание аккаунтов
• Команды
• Вкладка "Интересное" (больше не поддерживается)

Messenger Profile API позволяет настраивать, обновлять, извлекать и удалять свойства в профиле Messenger вашей Страницы.

Разрешения

Для взаимодействия с этой конечной точкой необходим маркер доступа к Странице с разрешением pages_messaging.

Если приложение находится в режиме разработки, настройки профиля Messenger будут видны только людям, у которых есть роль в этом приложении.

Содержание

• URI запроса
• Свойства профиля Messenger
• Извлечение свойств
• Настройка и обновление свойств
• Удаление свойств
• Ограничение числа обращений

URI запроса

https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

Свойства профиля Messenger

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

Извлечение свойств

Извлекает текущее значение одного или нескольких свойств профиля Messenger по имени.

Параметры запроса

Строка запроса содержит следующие параметры:

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

curl -X GET "https://graph.facebook.com/v19.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

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

Текущее значение запрошенных свойств возвращается в массиве data:

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

Настройка и обновление свойств

Задает значения одного или нескольких свойств профиля Messenger. Будут переопределены только те свойства, которые заданы в запросе.

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

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v18.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

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

{
    "result": "success"
}

Удаление свойств

Удаляет одно или несколько свойств профиля Messenger. Удаляются только те свойства, которые указаны в массиве fields.

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

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v19.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

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

{
    "result": "success"
}