Xác thực ứng dụng kinh doanh

Ứng dụng kinh doanh có sẵn trên giao diện của Facebook. Đây là nơi các doanh nghiệp nhỏ khám phá và kết nối với ứng dụng kinh doanh của bên thứ ba, từ đó dễ dàng thiết lập công cụ kinh doanh với chi phí công nghệ thấp để phát triển và đạt được mục tiêu kinh doanh của mình.

Không giống như tính năng Đăng nhập cho doanh nghiệp, vì quy trình Ứng dụng kinh doanh được chạy từ giao diện của chúng tôi, nên có thêm một bước yêu cầu người dùng đăng nhập vào nền tảng của bạn thông qua trình duyệt bật lên để xác thực và chọn doanh nghiệp cần kết nối (được xác định bằng một external_business_id do bạn xác định). Khi xác thực thành công, người dùng sẽ được chuyển hướng trở lại quy trình này để hoàn tất việc tích hợp.

Nếu muốn hiển thị ứng dụng của mình trên giao diện Ứng dụng kinh doanh, bạn cần tạo URL xác thực và điểm cuối Webhook, rồi thiết lập và xác thực qua Bảng điều khiển dành cho nhà phát triển.

Tất cả các ứng dụng phải đăng ký quy trình Xét duyệt tiện ích tích hợp. Sau khi việc tích hợp FBE được phê duyệt, ứng dụng của bạn sẽ có sẵn cho người dùng công khai.

Triển khai URL xác thực

Ứng dụng kinh doanh khởi chạy một quy trình tương tự như tính năng Đăng nhập cho doanh nghiệp từ giao diện Trang Facebook, Instagram và Facebook Business Suite. Để bật quy trình này và liệt kê ứng dụng của bạn trên đó, bạn phải cung cấp giao diện người dùng xác thực tùy chỉnh để cho phép người dùng chọn doanh nghiệp họ sở hữu trên trang web của bạn, sau đó chuyển hướng họ trở lại quy trình trên Facebook, Instagram hoặc Facebook Business Suite.

Cách thức hoạt động

1. Cung cấp điểm cuối URL tùy chỉnh (URL xác thực) sẽ tải quy trình xác thực trên nền tảng của bạn.
• URL xác thực phải chuyển người dùng (chủ doanh nghiệp) đến quy trình đăng nhập trên nền tảng của bạn.
• Đưa ra lựa chọn đăng ký tài khoản mới trên nền tảng của bạn (tức là "đăng ký"). Sau khi đăng ký, người dùng cần được chuyển trở lại Facebook để hoàn tất quá trình kết nối tài khoản của họ.
• Nếu bạn hỗ trợ nhiều doanh nghiệp trên mỗi tài khoản trong nền tảng của mình, URL xác thực sau khi đăng nhập thành công sẽ hiển thị giao diện người dùng để người dùng chọn doanh nghiệp mà họ muốn liên kết với tài sản trên Facebook.
Ví dụ - URL xác thực

https://yourwebsite.com/fbe-auth

2. Facebook tải URL xác thực bạn cung cấp trong quy trình tích hợp và thêm thông số truy vấn redirect_uri vào cuối (đây là URI chuyển hướng có thể bao gồm các thông số truy vấn bổ sung):

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   Ví dụ - Một URI chuyển hướng đã mã hóa mà Facebook có thể thêm vào thông số truy vấn redirect_uri:

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   Ở cuối bước này, Facebook sẽ tải URL xác thực của bạn với thông số truy vấn redirect_uri đã thêm và được mã hóa có dạng như sau:

   https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

   Lưu ý quan trọng: Để đảm bảo rằng bạn không chia sẻ bất kỳ dữ liệu người dùng nào với các bên khác, hãy chỉ chuyển hướng đến redirect_uri nếu URL đó khớp với biểu thức chính quy sau đây:

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. Sau khi người dùng hoàn tất quy trình đăng nhập/đăng ký và chọn một doanh nghiệp trên nền tảng của bạn (nếu có), hãy chuyển hướng họ đến URL từ redirect_uri sau khi thêm đối tượng extras đã mã hóa vào URL đó dưới dạng thông số truy vấn (giống như khi bạn sử dụng cho tính năng Đăng nhập cho doanh nghiệp) với business_config và setup được xác định trong thông số đó (tùy theo cấu hình tích hợp mà bạn muốn triển khai):

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

Xác thực iframe

Để mang lại trải nghiệm người dùng liền mạch hơn trong Ứng dụng kinh doanh và hỗ trợ việc tạo tài khoản mới trên nền tảng của bạn một cách hiệu quả hơn, bạn cần cho phép tải URL xác thực trong iframe trên giao diện Facebook. Hãy xem nguyên tắc triển khai và quy cách sau khi thông báo trong tài liệu về iframe.

Triển khai Webhook

Webhooks cho phép bạn nhận thông báo HTTP theo thời gian thực về những thay đổi đối với các đối tượng cụ thể trong Đồ thị mạng xã hội của Facebook. Đối với FBE, điều này có nghĩa là sau khi người dùng cài đặt hoặc gỡ cài đặt FBE bằng ứng dụng của bạn (ví dụ thông qua Ứng dụng kinh doanh), bạn sẽ nhận được thông tin chi tiết về hành động đó qua Webhooks.

Bạn nên tạo điểm cuối trên một máy chủ bảo mật có thể xử lý yêu cầu từ Facebook. Đây là thao tác bắt buộc cho tất cả đối tác nền tảng muốn hiển thị ứng dụng của mình trên Ứng dụng kinh doanh. Hãy xem hướng dẫn triển khai Webhook để biết chi tiết về cách tạo điểm cuối này.

Thiết lập và xác thực Webhook

Khi điểm cuối Webhook của bạn đã sẵn sàng, quy trình thiết lập và xác thực Webhook sẽ yêu cầu bạn:

1. Dùng thẻ Webhooks trong phần Tiện ích Facebook Business -> Thiết lập trên Bảng điều khiển ứng dụng để xác thực điểm cuối này và đăng ký nhận webhook fbe_install. Hãy xem Hướng dẫn triển khai Webhook để biết thêm chi tiết.
2. Khi sản phẩm Webhooks được đặt cấu hình đúng cách, vòng tròn ở trên cùng bên phải của thẻ này sẽ chuyển sang màu xanh lá cây và hiện biểu tượng dấu kiểm.

Thiết lập và xác thực qua Bảng điều khiển dành cho nhà phát triển

Bảng điều khiển dành cho nhà phát triển trên Tiện ích Facebook Business là sản phẩm trong Bảng điều khiển ứng dụng dành cho nhà phát triển. Sau khi các ứng dụng được cấp tính năng FBE, bạn cần sử dụng Bảng điều khiển dành cho nhà phát triển để thiết lập và xác thực URL xác thực, điểm cuối Webhook, cũng như bổ sung thông tin chi tiết về những tính năng mà ứng dụng của bạn cung cấp cho doanh nghiệp.

Thiết lập và xác thực URL xác thực

Khi URL xác thực đã sẵn sàng, quy trình thiết lập và xác thực URL sẽ yêu cầu bạn:

1. Chuyển đến Bảng điều khiển dành cho nhà phát triển trên FBE trong bảng điều khiển ứng dụng của bạn. Lưu ý: Nếu bạn chưa đặt cấu hình bảng điều khiển, hãy làm theo các hướng dẫn sau.
2. Nhấp vào tab Thiết lập và tìm thẻ giao diện Ứng dụng kinh doanh.
3. Tích vào ô để đánh dấu Hiển thị ứng dụng của tôi trên giao diện Ứng dụng kinh doanh.
4. Trong mục nhập URL xác thực, hãy nhập URL xác thực.
5. Nhấp vào nút Thử nghiệm xác thực.
• Một cửa sổ bật lên mở ra và tải URL của bạn để mô phỏng cách Facebook sẽ sử dụng URL đó trên giao diện Ứng dụng kinh doanh.
• Tiếp tục đăng nhập và lựa chọn doanh nghiệp (nếu có).
• Sau khi chuyển hướng, cửa sổ bật lên sẽ đóng. Nếu quá trình triển khai của bạn xảy ra lỗi (ví dụ: giá trị không hợp lệ trên extras), lỗi sẽ hiển thị ở cuối thẻ này để bạn biết lỗi cần khắc phục. Tính năng Thử nghiệm xác thực chỉ xác thực mục nhập trên redirect_uri và không thực sự cài đặt FBE.
6. Sau khi triển khai các bước triển khai và cấu hình extras như dự kiến, bước này sẽ được đánh dấu là hợp lệ (dấu kiểm màu xanh lá cây ở góc trên cùng bên phải của thẻ). Nhờ đó mà có thể thử nghiệm toàn bộ quy trình tích hợp này (cài đặt FBE) trực tiếp từ Facebook (xem phần bên dưới).

Thử nghiệm toàn bộ quy trình

Sau khi URL xác thực và điểm cuối Webhook được thiết lập cũng như xác thực thành công trên Bảng điều khiển dành cho nhà phát triển, bạn có thể thử nghiệm toàn bộ quy trình tích hợp (do ứng dụng của bạn cung cấp) trước khi chuyển sang chế độ chính thức. Bạn có thể thử nghiệm ngay trong Facebook Business Suite hoặc trên giao diện Trang Facebook như sau:

Thông qua Facebook Business Suite

1. Chuyển đến Facebook Business Suite.
2. Ở thanh trượt bên trái, hãy nhấp vào Công cụ khác rồi nhấp vào Ứng dụng kinh doanh.
3. Tất cả các ứng dụng có sẵn được liệt kê tại đây. Ứng dụng của bạn sẽ được liệt kê trong hạng mục bạn đã chọn làm Ngành dọc trên tab Thiết lập bảng điều khiển dành cho nhà phát triển.
4. Ứng dụng của bạn sẽ có nhãn Chỉ để thử nghiệm - Không công khai. Nghĩa là ứng dụng được cung cấp cho người dùng có vai trò trong ứng dụng chỉ để thử nghiệm, chứ chưa phát hành cho người dùng công khai.
5. Nhấp vào Kết nối và bắt đầu thử nghiệm trải nghiệm do URL xác thực của bạn cung cấp:
   • Quy trình tích hợp này sẽ cài đặt FBE thực và kích hoạt thông báo Webhook.

Thông qua giao diện Trang Facebook

1. Chuyển đến Trang Facebook mà bạn có quyền truy cập Quản trị viên.
2. Ở thanh trượt bên trái của Trang Facebook, hãy nhấp vào Ứng dụng kinh doanh.
3. Tất cả các ứng dụng có sẵn được liệt kê tại đây. Ứng dụng của bạn sẽ được liệt kê trong hạng mục bạn đã chọn làm Ngành dọc trên tab Thiết lập bảng điều khiển dành cho nhà phát triển.
4. Ứng dụng của bạn sẽ có nhãn Chỉ để thử nghiệm - Không công khai. Nghĩa là ứng dụng được cung cấp cho người dùng có vai trò trong ứng dụng chỉ để thử nghiệm, chứ chưa phát hành cho người dùng công khai.
5. Nhấp vào Kết nối và bắt đầu thử nghiệm trải nghiệm do URL xác thực của bạn cung cấp:
   • Quy trình tích hợp này sẽ cài đặt FBE thực và kích hoạt thông báo Webhook.

Tìm hiểu thêm

• Cách sử dụng tính năng Đăng nhập cho doanh nghiệp của FBE
• extras
• business_config
• setup
• Cách gỡ cài đặt FBE