Возможные варианты подключения и настройки бизнес-функций для расширения Facebook Business.
Чтобы включить и настроить бизнес-функции для пользователя, используйте один из следующих вариантов:
Вариант | Описание | Рекомендация |
---|---|---|
Передается в функцию входа от имени компании для включения или отключения функций расширения Facebook Business. Для партнеров эту возможность можно включить на панели расширения Facebook Business для разработчиков. При ее использовании партнеры должны уведомлять пользователей о том, что функции будут включены для них автоматически. | Рекомендуется, если у вас есть набор функций по умолчанию для пользователя. | |
Пользовательский интерфейс Facebook, в котором пользователи могут самостоятельно включать и отключать функции расширения Facebook Business. | Рекомендуется, если вы не хотите разрабатывать собственный пользовательский интерфейс, а также использовать функции Facebook и Instagram. | |
Создает пользовательское представление для управления функциями, в котором можно включать и отключать функции расширения Facebook Business. | Рекомендуется, если вы хотите создать собственное представление для управления функциями с нестандартным оформлением. |
Расширение Facebook Business предлагает множество функций для компаний.
Следующие функции сгруппированы по отраслям, для которых они подходят лучше всего:
Функция | Параметр | Описание |
---|---|---|
Призыв к действию на Странице Facebook |
Тип: FBEPageCtaConfigData | Кнопка призыва к действию на Странице Facebook компании |
Призыв к действию в Instagram |
Тип: FBEIGCtaConfigData | Кнопка призыва к действию в профиле компании в Instagram. |
Призыв к действию в Messenger |
| Кнопка призыва к действию, отображаемая в Messenger, когда пользователь переписывается с компанией. |
Чат Messenger |
| Позволяет интегрировать Messenger непосредственно на ваш сайт, чтобы клиенты могли в любой момент обратиться в вашу компанию. |
Функция | Параметр | Описание |
---|---|---|
Карточка с избранными услугами Страницы |
| Требуется каталог. Карточка с избранными услугами компании на ее Странице Facebook. |
Намерение отправлять сведения о свободных часах в переписке Messenger |
| Подсказки в Messenger администраторам компании, позволяющие легко отправлять пользователю в чате информацию о времени, доступном для встречи. |
Функция | Параметр | Описание |
---|---|---|
Призыв к действию на Странице Facebook |
Тип: FBEPageCtaConfigData | Кнопка призыва к действию на Странице Facebook компании |
Призыв к действию в Instagram |
Тип: FBEIGCtaConfigData | Кнопка призыва к действию в профиле компании в Instagram. |
Призыв к действию в Messenger |
| Кнопка призыва к действию, отображаемая в Messenger, когда пользователь переписывается с компанией. |
Намерение отправлять сведения о свободных часах в переписке Messenger |
| Подсказки в Messenger администраторам компании, позволяющие легко отправлять пользователю в чате информацию о времени, доступном для встречи. |
Функция | Параметр | Описание |
---|---|---|
Карточка с избранными услугами Страницы |
| Доступно только для отраслей, использующих функционал встреч. Требуется реализация каталога. Отображает карточку с избранными услугами компании на ее Странице в Facebook. Информацию об обязательных полях и форматах для отрасли услуг см. в разделе о каталоге расширения Facebook Business. |
Чат Messenger |
| Позволяет интегрировать Messenger непосредственно на ваш сайт. Эта функция позволяет клиентам в любой момент обратиться в вашу компанию с использованием всех возможностей, к которым они привыкли в Messenger. Если
<div class="fb-customerchat" page_id="<PAGE_ID>"> </div>
Полное руководство по реализации см. в статье Плагин чата. |
Вы можете настроить любое количество функций для компании, указав их в свойстве 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" }, }
Чтобы компания могла дополнительно настроить функции (помимо настроек, указанных в business_config
во время установки), направьте ее в представление для управления функциями расширения Facebook Business со своей платформы.
Добавить точку входа для запуска представления можно показанными ниже способами (SDK для JavaScript или URL). В обоих примерах отображается кнопка, при нажатии которой открывается окно управления расширением Facebook Business. Рекомендуем не показывать эту кнопку, пока клиент не завершит настройку расширения Facebook Business. В качестве external_business_id
следует передать fbe_external_business_id
.
В представлении для управления функциями расширения Facebook Business можно указать выбранную вкладку. Для этого нужно передать необязательный параметр tab
с именем нужной вкладки. Например, можно задать вкладку "Главная" или "Торговля". Этот параметр можно использовать в SDK для JavaScript или URL.
<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>;
<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.
Для ненастраиваемых функций отображаются только 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"