Đặt cấu hình tính năng kinh doanh

Tìm hiểu các tùy chọn có sẵn để bật và đặt cấu hình tính năng kinh doanh cho Tiện ích Facebook Business.

Tùy chọn cấu hình

Để bật và đặt cấu hình các tính năng kinh doanh cho người dùng, hãy sử dụng một trong các tùy chọn sau:

Tùy chọnMô tảĐề xuất

Thiết lập tính năng thông qua phương thức Đăng nhập doanh nghiệp

Được chuyển vào phương thức Đăng nhập doanh nghiệp để bật và tắt các tính năng của Tiện ích Facebook Business (FBE).

Bật tùy chọn thiết lập tính năng này cho đối tác thông qua Bảng điều khiển dành cho nhà phát triển FBE. Khi sử dụng tính năng này, đối tác nên thông báo để người dùng biết rằng các tính năng nêu trên tự động được bật cho họ.

Khuyên dùng nếu bạn cần thiết lập một nhóm tính năng mặc định cho người dùng.

Chế độ quản lý tính năng

Giao diện người dùng tự phục vụ của Facebook để người dùng bật và tắt các tính năng của FBE.

Khuyên dùng nếu bạn không muốn tạo giao diện người dùng mà sử dụng giao diện người dùng tự phục vụ của Facebook. Bạn cũng nên dùng chế độ này nếu không muốn tạo các tính năng của Facebook và Instagram cho giao diện người dùng.

API Cấu hình tính năng

Tạo chế độ quản lý tính năng tùy chỉnh để bật và tắt các tính năng của FBE.

Khuyên dùng nếu bạn muốn tạo chế độ quản lý tính năng của riêng mình để khớp với giao diện của người dùng.

Tính năng được hỗ trợ

Tiện ích Facebook Business cung cấp nhiều tính năng mà bạn có thể bật cho doanh nghiệp của mình.

Các tính năng dưới đây được nhóm theo ngành dọc phù hợp nhất:

Tính năng tiêu chuẩn

Tính năngThông sốMô tả

Nút kêu gọi hành động trên Trang Facebook

page_cta(s)

Loại: FBEPageCtaConfigData

Nút Kêu gọi hành động (CTA) trên Trang Facebook của doanh nghiệp.

Nút kêu gọi hành động trên Instagram

ig_cta(s)

Loại: FBEIGCtaConfigData

Nút Kêu gọi hành động (CTA) trên Trang Instagram của doanh nghiệp.

Nút kêu gọi hành động trên Messenger

messenger_menu

Loại: FBEMessengerMenuConfigData

Nút Kêu gọi hành động (CTA) trên Messenger khi người dùng nhắn tin cho doanh nghiệp.

Chat trên Messenger

messenger_chat

Loại: FBEMessengerChatConfigData

Bật tiện ích tích hợp Messenger ngay trên trang web của bạn để khách hàng có thể tương tác với doanh nghiệp bạn bất cứ lúc nào.

Tính năng dành riêng cho ngành dọc CUỘC HẸN

Tính năngThông sốMô tả

Thẻ trang dịch vụ đáng chú ý

page_card

Loại: FBEPageCardConfigData

Cần có Danh mục.

Thẻ có các dịch vụ đáng chú ý của doanh nghiệp trên Trang Facebook của doanh nghiệp đó.

Ý định gửi khung giờ trống qua chuỗi trò chuyện trên Messenger

thread_intent

Loại: FBEThreadIntentConfigData

Gợi ý của Messenger dành cho quản trị viên doanh nghiệp để dễ dàng gửi khung giờ trống cho cuộc hẹn đến một người dùng trong đoạn chat.

Không yêu cầu triển khai bổ sung

Tính năngThông sốMô tả

Nút kêu gọi hành động trên Trang Facebook

page_cta

Loại: FBEPageCtaConfigData

Nút Kêu gọi hành động (CTA) trên Trang Facebook của doanh nghiệp.

Nút kêu gọi hành động trên Instagram

ig_cta

Loại: FBEIGCtaConfigData

Nút Kêu gọi hành động (CTA) trên Trang Instagram của doanh nghiệp.

Nút kêu gọi hành động trên Messenger

messenger_menu

Loại: FBEMessengerMenuConfigData

Nút Kêu gọi hành động (CTA) trên Messenger khi người dùng nhắn tin cho doanh nghiệp.

Ý định gửi khung giờ trống qua chuỗi trò chuyện trên Messenger

thread_intent

Loại: FBEThreadIntentConfigData

Gợi ý của Messenger dành cho quản trị viên doanh nghiệp để dễ dàng gửi khung giờ trống cho cuộc hẹn đến một người dùng trong đoạn chat.

Yêu cầu triển khai bổ sung

Tính năngThông sốMô tả

Thẻ trang dịch vụ đáng chú ý

page_card

Loại: FBEPageCardConfigData

Chỉ áp dụng cho ngành dọc CUỘC HẸN.

Cần phải triển khai Danh mục.

Bật thẻ có các dịch vụ đáng chú ý của doanh nghiệp trên Trang Facebook của doanh nghiệp đó. Hãy xem phần Danh mục FBE để biết các định dạng và trường bắt buộc dành cho ngành dọc DỊCH VỤ.

Chat trên Messenger

messenger_chat

Loại: FBEMessengerChatConfigData

Bật tiện ích tích hợp Messenger ngay trên trang web của bạn. Nhờ tính năng này, khách hàng có thể tương tác với doanh nghiệp của bạn bất cứ lúc nào thông qua chính trải nghiệm đa phương tiện, cá nhân hóa mà họ có trong Messenger.

Nếu messenger_chat trả về enabled: true từ API Cấu hình tính năng:

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • Bạn có thể lấy page_id qua Webhook hoặc theo hướng dẫn về điểm cuối cài đặt FBE.
  • Facebook tự động tìm nạp các mục tùy chỉnh dựa trên page_id được chuyển vào. Do đó, bạn không phải chuyển bất kỳ mục tùy chỉnh nào một cách rõ ràng.

Để biết hướng dẫn triển khai đầy đủ, hãy xem phần Plugin chat với khách hàng.

Thiết lập tính năng ban đầu thông qua phương thức Đăng nhập doanh nghiệp

Bạn có thể đặt cấu hình số lượng tính năng bất kỳ cho doanh nghiệp mình bằng cách chỉ định các tính năng đó trong thuộc tính business_config - được chuyển vào qua thông số extras bằng cả phương thức Đăng nhập doanh nghiệp lẫn trên App Store. Tại đây, bạn sẽ chỉ định tất cả tính năng muốn bật cho doanh nghiệp mình ngay khi cài đặt xong FBE.

business_config là một đối tượng JSON chứa các trường phụ để mô tả cách đặt cấu hình những tính năng khác nhau. Hãy tìm hiểu thêm về các trường phụ để chỉ định và business_config. Ví dụ: để đặt cấu hình riêng nút CTA trên Trang Facebook và nút CTA trên Instagram của doanh nghiệp, đối tượng business_config của bạn sẽ có dạng như sau:

{
  "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"
  },
}

Chế độ quản lý tính năng FBE

Để cho phép doanh nghiệp đặt cấu hình thêm tính năng (ngoài những tính năng bạn chỉ định cho họ trong business_config khi cài đặt), bạn có thể chuyển các doanh nghiệp trên nền tảng của bạn sang Chế độ quản lý tính năng FBE của chúng tôi.

Bạn có thể thêm điểm truy cập để khởi chạy Chế độ quản lý tính năng FBE bằng cách thêm một trong những phương thức sau (Javascript SDK hoặc URL). Cả hai ví dụ đều hiển thị một nút để khởi chạy cửa sổ Chế độ quản lý FBE khi người dùng nhấp vào. Bạn nên ẩn nút khởi chạy FBE cho đến khi khách hàng hoàn tất quá trình thiết lập FBE. Hãy đảm bảo bạn chuyển fbe_external_business_id cho external_business_id.

Bạn có thể chỉ định tab đã chọn cho Chế độ quản lý FBE bằng cách chuyển thông số không bắt buộc tab có tên của tab mong muốn. Ví dụ: có thể đặt thông số này thành "Trang chủ" hoặc "Thương mại". Có thể sử dụng thông số này trong Javascript SDK hoặc với phương thức 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>;

Phương thức 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 Cấu hình tính năng FBE

Để đặt cấu hình và cập nhật các tính năng của doanh nghiệp từ phía bạn sau giai đoạn cài đặt ban đầu, bạn có thể sử dụng API Cấu hình tính năng FBE.

Đối với những tính năng không thể tùy chỉnh, chỉ có ID phiên bản tính năng và cờ đã bật hiển thị. Bạn chỉ có thể cập nhật các tính năng tùy chỉnh thông qua yêu cầu POST.

API Cấu hình tính năng khác với API Cài đặt FBE vì cung cấp thêm thông tin về tính năng ngoài các tài sản được kết nối, bao gồm cả trạng thái đã bật và mục tùy chỉnh tính năng cụ thể. Sau khi gọi API Cài đặt FBE, bạn hãy dùng API Cấu hình tính năng nếu cần có thêm thông tin về trạng thái đã bật hoặc cấu hình của tính năng.

Với các điểm cuối API sau đây, bạn có thể bật, tắt và đặt cấu hình tính năng cho một doanh nghiệp cụ thể trên nền tảng của bạn nếu họ đã cài đặt FBE. access_token dùng cho các điểm cuối này là mã được trả về cho bạn thông qua phương thức Đăng nhập doanh nghiệp hoặc Webhook.

Bạn không nên lưu trữ cấu hình doanh nghiệp trên máy chủ của mình. Bạn nên liên tục truy vấn, sau đó sửa đổi cấu hình thông qua các API được xác định bên dưới. Người dùng có thể thay đổi các tính năng đó trên nền tảng Facebook hoặc thông qua Chế độ quản lý FBE. Do đó, nền tảng của bạn có thể không có cấu hình mới nhất.

Đọc

Bạn có thể đọc trạng thái cấu hình tính năng hiện tại của bất kỳ doanh nghiệp nào bằng cách gửi yêu cầu dưới đây:

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

Phản hồi

Xem đối tượng business_config.

Cập nhật

Để cập nhật tất cả hoặc một tính năng bất kỳ, hãy gửi yêu cầu POST dưới đây:

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"

Phản hồi

Phản hồi mẫu.

    {
  "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,
    },
  ],
  ...
}

Bật và đặt cấu hình nút Kêu gọi hành động trên trang của người dùng cuối rồi gửi yêu cầu 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"

Tìm hiểu thêm

Danh mục