Настройка бизнес-функций

Возможные варианты подключения и настройки бизнес-функций для расширения Facebook Business.

Варианты настройки

Чтобы включить и настроить бизнес-функции для пользователя, используйте один из следующих вариантов:

ВариантОписаниеРекомендация

Настройка функции через вход от имени компании

Передается в функцию входа от имени компании для включения или отключения функций расширения Facebook Business.

Для партнеров эту возможность можно включить на панели расширения Facebook Business для разработчиков. При ее использовании партнеры должны уведомлять пользователей о том, что функции будут включены для них автоматически.

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

Представление для управления функциями

Пользовательский интерфейс Facebook, в котором пользователи могут самостоятельно включать и отключать функции расширения Facebook Business.

Рекомендуется, если вы не хотите разрабатывать собственный пользовательский интерфейс, а также использовать функции Facebook и Instagram.

API Feature Configuration

Создает пользовательское представление для управления функциями, в котором можно включать и отключать функции расширения Facebook Business.

Рекомендуется, если вы хотите создать собственное представление для управления функциями с нестандартным оформлением.

Поддерживаемые функции

Расширение Facebook Business предлагает множество функций для компаний.

Следующие функции сгруппированы по отраслям, для которых они подходят лучше всего:

Стандартные функции

ФункцияПараметрОписание

Призыв к действию на Странице Facebook

page_cta(s)

Тип: FBEPageCtaConfigData

Кнопка призыва к действию на Странице Facebook компании

Призыв к действию в Instagram

ig_cta(s)

Тип: FBEIGCtaConfigData

Кнопка призыва к действию в профиле компании в Instagram.

Призыв к действию в Messenger

messenger_menu

Тип: FBEMessengerMenuConfigData

Кнопка призыва к действию, отображаемая в Messenger, когда пользователь переписывается с компанией.

Чат Messenger

messenger_chat

Тип: FBEMessengerChatConfigData

Позволяет интегрировать Messenger непосредственно на ваш сайт, чтобы клиенты могли в любой момент обратиться в вашу компанию.

Функции для встреч

ФункцияПараметрОписание

Карточка с избранными услугами Страницы

page_card

Тип: FBEPageCardConfigData

Требуется каталог.

Карточка с избранными услугами компании на ее Странице Facebook.

Намерение отправлять сведения о свободных часах в переписке Messenger

thread_intent

Тип: FBEThreadIntentConfigData

Подсказки в Messenger администраторам компании, позволяющие легко отправлять пользователю в чате информацию о времени, доступном для встречи.

Функции, не требующие дополнительной реализации

ФункцияПараметрОписание

Призыв к действию на Странице Facebook

page_cta

Тип: FBEPageCtaConfigData

Кнопка призыва к действию на Странице Facebook компании

Призыв к действию в Instagram

ig_cta

Тип: FBEIGCtaConfigData

Кнопка призыва к действию в профиле компании в Instagram.

Призыв к действию в Messenger

messenger_menu

Тип: FBEMessengerMenuConfigData

Кнопка призыва к действию, отображаемая в Messenger, когда пользователь переписывается с компанией.

Намерение отправлять сведения о свободных часах в переписке Messenger

thread_intent

Тип: FBEThreadIntentConfigData

Подсказки в Messenger администраторам компании, позволяющие легко отправлять пользователю в чате информацию о времени, доступном для встречи.

Функции, требующие дополнительной реализации

ФункцияПараметрОписание

Карточка с избранными услугами Страницы

page_card

Тип: FBEPageCardConfigData

Доступно только для отраслей, использующих функционал встреч.

Требуется реализация каталога.

Отображает карточку с избранными услугами компании на ее Странице в Facebook. Информацию об обязательных полях и форматах для отрасли услуг см. в разделе о каталоге расширения Facebook Business.

Чат Messenger

messenger_chat

Тип: FBEMessengerChatConfigData

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

Если messenger_chat возвращает enabled: true из API Feature Configuration:

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • page_id можно получить через Webhook или конечную точку API установок расширения Facebook Business (см. инструкции);
  • Facebook автоматически получает настройки на основании переданного page_id, поэтому передавать их явным образом не нужно.

Полное руководство по реализации см. в статье Плагин чата.

Начальная настройка функций через вход от имени компании

Вы можете настроить любое количество функций для компании, указав их в свойстве business_config, которое передается через параметр extras как при использовании входа от имени компании, так и в App Store. Включите таким образом все нужные функции для компании после установки расширения Facebook Business.

business_config — это объект JSON, вложенные поля которого служат для настройки различных функций. Подробнее об объекте business_config и его вложенных полях см. в этом разделе. Например, чтобы настроить для компании только призыв к действию на Странице Facebook и в Instagram, используйте такой объект business_config:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

Представление для управления функциями расширения Facebook Business

Чтобы компания могла дополнительно настроить функции (помимо настроек, указанных в business_config во время установки), направьте ее в представление для управления функциями расширения Facebook Business со своей платформы.

Добавить точку входа для запуска представления можно показанными ниже способами (SDK для JavaScript или URL). В обоих примерах отображается кнопка, при нажатии которой открывается окно управления расширением Facebook Business. Рекомендуем не показывать эту кнопку, пока клиент не завершит настройку расширения Facebook Business. В качестве external_business_id следует передать fbe_external_business_id.

В представлении для управления функциями расширения Facebook Business можно указать выбранную вкладку. Для этого нужно передать необязательный параметр tab с именем нужной вкладки. Например, можно задать вкладку "Главная" или "Торговля". Этот параметр можно использовать в SDK для JavaScript или URL.

Facebook SDK для JavaScript

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

С использованием URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API Feature Configuration для расширения Facebook Business

Чтобы настроить или обновить функции компании после установки, вы можете использовать API Feature Configuration для расширения Facebook Business.

Для ненастраиваемых функций отображаются только ID экземпляра функции и включенный флаг. С помощью запроса POST можно обновлять только настраиваемые функции.

API Feature Configuration отличается от API FBE Installation тем, что первый, помимо данных о связанных объектах, предоставляет дополнительную информацию о функциях, в том числе статус включения и определенные настройки функций. После вызова API FBE Installation используйте API Feature Configuration, чтобы получить дополнительную информацию о статусе включения или конфигурациях для определенной функции.

Перечисленные ниже конечные точки API позволяют включить, отключить или настроить функции для определенной компании, установившей расширение Facebook Business, на вашей платформе. Для них используется access_token, возвращенный через вход от имени компании или Webhook.

Мы не рекомендуем хранить конфигурации для компаний на ваших серверах. Их следует запрашивать и изменять только с помощью представленных ниже API. Пользователи могут изменить функции на платформе Facebook или в представлении для управления расширением Facebook Business. В этом случае у вас на серверах окажутся неактуальные конфигурации.

Чтение

Чтобы получить текущую конфигурацию функций для любой компании, выполните следующий запрос:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Ответ

См. описание объекта business_config.

Обновление

Чтобы обновить функции, выполните следующий запрос POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Ответ

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

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Чтобы включить и настроить кнопку призыва к действию на странице пользователя, отправьте запрос POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Подробнее

Каталог