配置业务功能

了解用于启用和配置 Facebook 业务插件业务功能的可用选项。

配置选项

如要为用户启用和配置业务功能,请使用以下其中一个可用选项:

选项描述建议使用场景

通过企业登录进行功能设置

将该选项传递到企业登录以启用和禁用 Facebook 业务插件 (FBE) 功能。

通过 FBE 开发者面板为合作伙伴启用此功能选项。使用此功能时,合作伙伴应让用户知道,系统会自动为他们启用这些功能。

如果您有一组要为用户设置的默认功能,则建议使用此选项。

功能管理视图

供用户启用和禁用 FBE 功能的自助服务 Facebook 用户界面。

如果您不希望构建用户界面和使用 Facebook 的用户界面自助服务,也不希望使用其 Facebook 和 Instagram 功能,则建议使用此选项。

功能配置 API

创建自定义功能管理视图,以启用和禁用 FBE 功能。

如要构建您自己的功能管理视图,以与用户的功能管理视图的外观和风格相匹配,则建议使用此选项。

支持的功能

Facebook 业务插件提供了许多您可以为企业启用的功能。

下方列出的功能按照其最契合的垂直领域进行了分组:

标准功能

功能参数描述

Facebook 公共主页行动号召

page_cta(s)

类型:FBEPageCtaConfigData

企业 Facebook 公共主页上的行动号召 (CTA) 按钮。

Instagram 行动号召

ig_cta(s)

类型:FBEIGCtaConfigData

企业 Instagram 主页上的行动号召 (CTA) 按钮。

Messenger 行动号召

messenger_menu

类型:FBEMessengerMenuConfigData

当用户向企业发送消息时,Messenger 中的行动号召 (CTA) 按钮。

Messenger 聊天

messenger_chat

类型:FBEMessengerChatConfigData

将 Messenger 直接集成到您的网站上,以便客户随时与您的企业进行互动。

“预约”专用功能

功能参数描述

公共主页精选服务展示卡

page_card

类型:FBEPageCardConfigData

需要目录

含有企业 Facebook 公共主页上的精选服务的图卡。

Messenger 发送可预约信息对话意向

thread_intent

类型:FBEThreadIntentConfigData

为商务管理平台管理员提供的 Messenger 建议,以便他们通过聊天轻松向客户发送可预约时段。

无需进行额外设置

功能参数描述

Facebook 公共主页行动号召

page_cta

类型:FBEPageCtaConfigData

企业 Facebook 公共主页上的行动号召 (CTA) 按钮。

Instagram 行动号召

ig_cta

类型:FBEIGCtaConfigData

企业 Instagram 主页上的行动号召 (CTA) 按钮。

Messenger 行动号召

messenger_menu

类型:FBEMessengerMenuConfigData

当用户向企业发送消息时,Messenger 中的行动号召 (CTA) 按钮。

Messenger 发送可预约信息对话意向

thread_intent

类型:FBEThreadIntentConfigData

为商务管理平台管理员提供的 Messenger 建议,以便他们通过聊天轻松向客户发送可预约时段。

需要进行额外设置

功能参数描述

公共主页精选服务展示卡

page_card

类型:FBEPageCardConfigData

仅适用于“预约”垂直领域

需要设置目录

在企业 Facebook 公共主页上启用精选服务图卡。如需了解“服务”垂直领域所需的字段和格式,请参阅 FBE 目录

Messenger 聊天

messenger_chat

类型:FBEMessengerChatConfigData

将 Messenger 直接集成到您的网站。此功能可让客户随时与您的企业互动,同时获得与使用 Messenger 相同的个性化富媒体体验。

如果 messenger_chat 通过功能配置 API 返回了 enabled: true

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • 可通过 Webhooks 或 FBE 安装端点指南获得 page_id
  • Facebook 会根据传入的 page_id 自动获取定制项;因此,不需要明确传递任何定制项。

如需完整实现指南,请参阅客户聊天插件

通过企业登录设置初始功能

您可以通过在 business_config 属性(在企业登录和应用商店中通过 extras 参数传入)中指定功能,为企业配置任意数量的功能。完成 FBE 安装后,您应立即在此处指定所有您要为企业启用的功能。

business_config 是一个 JSON 对象,其中包含用于说明如何配置不同功能的子字段。详细了解要指定的子字段和 business_config。例如,如要仅配置企业 Facebook 公共主页行动号召 (CTA) 和 Instagram 行动号召 (CTA),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"
  },
}

FBE 功能管理视图

如要允许企业配置更多功能(除您于安装期间在 business_config 中为企业指定的功能以外的功能),您可以将企业从您的平台引导至我们的 FBE 管理视图。

您可以通过添加以下任何方法(JavaScript SDK 或网址)来添加接入点,以便启动 FBE 管理视图。这两个示例的作用是显示一个按钮,点击该按钮后会启动 FBE 管理模式窗口。建议在客户完成 FBE 设置之前隐藏 FBE 启动按钮。请务必在 external_business_id 中传递 fbe_external_business_id

您可以通过传递可选参数 tab 和所需选项卡的名称,指定 FBE 管理视图的选定选项卡。例如,可将该参数设置为“首页”或“商务”。您可在 JavaScript SDK 中使用该参数,或将该参数与网址方法一起使用。

JavaScript 版 Facebook SDK

<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>

FBE 功能配置 API

如要在完成企业功能的初始安装后,从您这一端配置和更新这些功能,您可以使用 FBE 功能配置 API

对于不可自定义的功能,系统只会显示一个功能实例编号和一个表示已启用的标记。只有可自定义的功能才能通过 POST 请求进行更新。

与 FBE 安装 API 不同,功能配置 API 能够提供除关联资产之外的其他功能信息,包括已启用状态和具体的功能自定义信息。调用 FBE 安装 API 后,如果需要有关功能的启用状态或配置的更多信息,请使用功能配置 API。

以下 API 端点可以让您在已安装 FBE 的平台上为特定企业启用、禁用和配置功能。这些端点所使用的 access_token 是您通过企业登录或 Webhooks 返回内容获取的访问口令。

我们不建议在您的服务器上存储企业配置。您应始终通过下方定义的 API 查询及修改配置。因为用户可能在 Facebook 平台上或通过 FBE 管理视图更改这些功能,而且您的平台可能不具有最新配置。

读取

您可以通过发出以下请求,读取任何企业的当前功能配置状态:

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"

详细了解

目录