비즈니스 기능 구성

Facebook Business 확장 기능에 대해 비즈니스 기능을 활성화하고 구성하는 데 사용할 수 있는 옵션을 알아보세요.

구성 옵션

사용자에 대해 비즈니스 기능을 활성화하고 구성하려면 다음의 이용 가능한 옵션 중 하나를 사용하세요.

옵션설명권장 사항

비즈니스 로그인을 통한 기능 설정

비즈니스 로그인으로 전달하여 Facebook Business 확장 프로그램(FBE) 기능을 활성화 및 비활성화합니다.

파트너의 경우FBE 개발자 패널을 통해 이 기능 옵션을 활성화합니다. 이 기능을 사용하는 파트너는 사용자에게 이러한 기능이 자동으로 활성화된다고 알려야 합니다.

사용자를 위해 설정할 기본 기능 세트가 있는 경우에 권장됩니다.

기능 관리 보기

사용자가 FBE 기능을 활성화 및 비활성화할 수 있는 셀프 서비스 Facebook UI입니다.

UI를 빌드하여 Facebooks의 UI 셀프 서비스를 사용하고 싶지 않거나 Facebook 및 Instagram 기능을 사용하고 싶지 않은 경우에 권장됩니다.

기능 구성 API

FBE 기능을 활성화 및 비활성화할 맞춤 설정 기능 관리 보기를 생성합니다.

사용자의 스타일과 일치하는 자체 기능 관리 보기를 빌드하는 경우에 권장됩니다.

지원되는 기능

Facebook Business 확장 기능은 비즈니스에 사용할 수 있는 다양한 기능을 제공합니다.

가장 적절한 카테고리별로 그룹화한 기능은 다음과 같습니다.

표준 기능

기능매개변수설명

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>
  • page_id는 Webhooks 또는 FBE 설치 엔드포인트 가이드를 통해 얻을 수 있습니다.
  • Facebook이 전달된 page_id에 따라 맞춤화를 자동으로 가져오므로 명시적으로 맞춤화를 전달할 필요가 없습니다.

전체 구현 가이드는 고객 채팅 플러그인을 참조하세요.

비즈니스 로그인을 통한 최초 기능 설정

business_config 속성에 기능을 지정하면 비즈니스에 대한 기능을 원하는 만큼 구성할 수 있습니다. 이 속성은 비즈니스 로그인과 App Store에서 모두 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 또는 URL) 중 아무 것이나 추가하여 FBE 관리 보기를 시작하기 위한 진입점을 추가할 수 있습니다. 두 예시는 모두 클릭할 버튼을 보여주며, 버튼을 클릭하면 FBE 관리 모드 창이 시작됩니다. 고객이 FBE 설정을 완료할 때까지 FBE 시작 버튼을 숨기는 것이 좋습니다. external_business_id에 대해 fbe_external_business_id를 전달하는 것을 잊지 마세요.

원하는 탭의 이름을 포함하여 선택 매개변수인 tab을 전달하면 FBE 관리 뷰에 대해 선택된 탭을 지정할 수 있습니다. 예를 들어 '홈' 또는 '커머스'로 설정할 수 있습니다. 이 매개변수는 Javascript SDK에서 사용하거나 URL 메서드와 함께 사용할 수 있습니다.

Facebook Javascript 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>;

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>

FBE 기능 구성 API

최초 설치 후 개발자가 비즈니스의 기능을 구성 및 업데이트하려면 FBE 기능 구성 API를 사용할 수 있습니다.

맞춤 설정이 불가능한 기능의 경우 기능 인스턴스 ID와 활성화된 플래그만 표시됩니다. 맞춤 설정 가능한 기능만 POST 요청으로 업데이트할 수 있습니다.

기능 구성 API가 FBE 설치 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"

더 알아보기

카탈로그