Đăng nhập bằng Facebook cho doanh nghiệp

Đăng nhập bằng Facebook cho doanh nghiệp là một giải pháp xác thực và ủy quyền ưu tiên dành cho những nhà cung cấp công nghệ đang xây dựng tiện ích tích hợp thông qua công cụ kinh doanh của Meta để tạo ra các giải pháp marketing, nhắn tin và bán hàng.

Với giải pháp Đăng nhập bằng Facebook cho doanh nghiệp, bạn có thể tạo trải nghiệm đăng nhập trong Bảng điều khiển ứng dụng trên Meta dựa theo nhu cầu của ứng dụng. Bạn có thể chỉ định loại mã truy cập, tài sản và những quyền mà ứng dụng của bạn cần rồi lưu làm cấu hình. Trong quá trình đăng nhập, người dùng ứng dụng sẽ nhìn thấy cấu hình này. Với cấu hình này, người dùng có thể cấp cho ứng dụng của bạn quyền truy cập vào tài sản doanh nghiệp của họ.

Yêu cầu

• Ứng dụng của bạn trên Meta phải thuộc loại ứng dụng dành cho doanh nghiệp
• Người dùng ứng dụng phải cấp tất cả những quyền mà ứng dụng của bạn yêu cầu trong quá trình đăng nhập. Nếu không, ứng dụng đó sẽ không được cấp bất kỳ quyền nào.
• Các quyền email và public_profile sẽ tự động được cấp cho tất cả ứng dụng, nhưng phải đi kèm với ít nhất một quyền được hỗ trợ khác cho mỗi lượt cài đặt ứng dụng.
• Để phục vụ các doanh nghiệp mà bạn không sở hữu hoặc quản lý, ứng dụng của bạn phải được phê duyệt Quyền truy cập nâng cao thông qua quy trình Xét duyệt ứng dụng của Meta
• Các ứng dụng có Quyền truy cập nâng cao phải trải qua quy trình Xét duyệt liên tục để duy trì quyền truy cập. Tuy nhiên, các ứng dụng dùng giải pháp Đăng nhập bằng Facebook cho doanh nghiệp không phải trải qua một số quy trình xét duyệt liên tục về tính tuân thủ do những ứng dụng này chỉ có thể sử dụng các quyền và tính năng dành cho doanh nghiệp.

Quyền được hỗ trợ

Bảng dưới đây liệt kê các quyền có sẵn cho giải pháp Đăng nhập bằng Facebook cho doanh nghiệp.

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

Sản phẩm được hỗ trợ

Mã truy cập được hỗ trợ

Bạn có thể dùng giải pháp Đăng nhập bằng Facebook cho doanh nghiệp để lấy mã truy cập dành cho Người dùng hoặc mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp.

Mã truy cập dành cho người dùng

Bạn nên sử dụng mã truy cập dành cho Người dùng nếu ứng dụng của bạn thực hiện các hành động theo thời gian thực, dựa trên dữ liệu nhập của người dùng. Ví dụ: hãy sử dụng mã truy cập dành cho người dùng nếu ứng dụng của bạn yêu cầu người dùng nhập văn bản và nhấp vào một nút để đăng nội dung lên Trang của họ. Bạn cũng nên sử dụng mã truy cập dành cho Người dùng nếu cần một API yêu cầu quyền quản trị đối với hồ sơ doanh nghiệp.

Mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp

Bạn nên sử dụng mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp nếu ứng dụng của bạn thực hiện các hành động tự động, theo lập trình trên tài sản của khách hàng doanh nghiệp mà không phải dựa vào dữ liệu nhập của người dùng ứng dụng hay yêu cầu xác thực lại sau này. Ví dụ:

• Tự động gọi API chuyển đổi giữa các máy chủ theo giờ
• Gửi tin trả lời tự động với vai trò Trang Facebook hoặc hồ sơ doanh nghiệp trên WhatsApp
• Tự động cập nhật danh sách cung ứng cho danh mục sản phẩm một cách liên tục
• Tự động truy xuất thông tin chi tiết về quảng cáo

Yêu cầu

Cách lấy mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp từ khách hàng doanh nghiệp:

• Ứng dụng của bạn chỉ có thể yêu cầu đăng nhập từ giao diện web
• Doanh nghiệp đang tích hợp vào ứng dụng của bạn phải có hoặc sẵn sàng tạo một hồ sơ doanh nghiệp
• Ứng dụng của bạn phải được liên kết với một hồ sơ doanh nghiệp mà bạn có toàn quyền kiểm soát. Hồ sơ này cần phải tách biệt với hồ sơ doanh nghiệp do khách hàng doanh nghiệp của bạn sở hữu.

Để thử nghiệm quy trình mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp, người dùng thử phải có vai trò trên ứng dụng và có toàn quyền kiểm soát doanh nghiệp khách hàng.

Mã truy cập chi tiết dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp

Nếu cần áp dụng cách thiết lập quyền truy cập khác nhau cho các mục đích hoặc bộ phận khác nhau, bạn có thể sử dụng nhiều mã truy cập chi tiết dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp cho từng doanh nghiệp khách hàng để tăng khả năng mở rộng và bảo mật cho tiện ích tích hợp.

Mã truy cập chi tiết vẫn dành riêng cho hồ sơ doanh nghiệp của khách hàng. Các doanh nghiệp khách hàng khác nhau không thể truy cập và dùng chung mã này. Danh sách tài sản và phạm vi của mã truy cập chi tiết là tập hợp con của mã truy cập gốc dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp.

Để cô lập các sự cố bảo mật tiềm ẩn trong trường hợp mã bị xâm phạm, chỉ doanh nghiệp khách hàng cụ thể đó mới bị ảnh hưởng, thay vì ảnh hưởng đến tất cả hồ sơ doanh nghiệp trên mọi doanh nghiệp khách hàng.

API Quản lý mã truy cập dành cho Người dùng hệ thống của Tiện ích tích hợp cho doanh nghiệp

Khi doanh nghiệp khách hàng cài đặt ứng dụng qua giải pháp Đăng nhập bằng Facebook cho doanh nghiệp và tạo mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp, mã đó sẽ bao gồm ID doanh nghiệp khách hàng. ID này biểu thị doanh nghiệp khách hàng. Ứng dụng của bạn sẽ dùng ID này để thực hiện lệnh gọi API.

Với điểm cuối /<CLIENT_BUSINESS_ID>/system_user_access_tokens, bạn có thể quản lý các mã truy cập hiện có dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp. Các hành động bao gồm:

• Tạo mã truy cập chi tiết dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp từ mã truy cập hiện có dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp
• Tìm nạp các mã truy cập hiện có dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp

Thông số

Yêu cầu mẫu

Được định dạng để dễ đọc.

curl -i -X POST "https://graph.facebook.com/v21.0/<CLIENT_BUSINESS_ID>/system_user_access_tokens
    ?appsecret_proof=<APPSECRET_PROOF_HASH>
    &access_token=<ACCESS_TOKEN>
    &system_user_id=<SYSTEM_USER_ID>
    &fetch_only=true"

Khi thành công, ứng dụng sẽ nhận được phản hồi JSON chứa mã truy cập mới sẽ được dùng trong các lệnh gọi API tiếp theo.

{
  "access_token": "<NEW_ACCESS_TOKEN>" 
}

So sánh

Trải nghiệm quy trình đăng nhập

Quy trình đăng nhập bằng mã truy cập dành cho Người dùng	Quy trình đăng nhập bằng mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp
Đã xảy ra lỗi Chúng tôi đã gặp sự cố khi phát video này. Tìm hiểu thêm	Đã xảy ra lỗi Chúng tôi đã gặp sự cố khi phát video này. Tìm hiểu thêm

Bắt đầu

Dưới đây là các bước cần thiết để thiết lập giải pháp Đăng nhập bằng Facebook cho doanh nghiệp nếu bạn chưa có ứng dụng.

Tạo ứng dụng

1. Trong Bảng điều khiển ứng dụng của Meta, hãy tạo một ứng dụng thuộc loại dành cho Doanh nghiệp.
2. Thêm sản phẩm Đăng nhập bằng Facebook cho doanh nghiệp.
3. Trong menu bên trái, chọn Cấu hình.
4. Bạn có thể chọn + Tạo cấu hình để tạo một cấu hình hoặc Tạo từ mẫu để chọn một trong các cấu hình đặt sẵn của Meta. Bạn có thể tạo nhiều cấu hình và hiển thị cho các nhóm người dùng khác nhau.
5. Đặt tên cho cấu hình
6. Chọn loại mã truy cập bạn muốn yêu cầu từ khách hàng doanh nghiệp, mã truy cập dành cho Người dùng hay mã truy cập dành cho Người dùng hệ thống và thời gian mã hết hạn. Nếu bạn chọn mã truy cập dành cho Người dùng, người dùng ứng dụng sẽ đăng nhập bằng tài khoản Facebook cá nhân của họ. Nếu bạn chọn mã truy cập dành cho Người dùng hệ thống, hệ thống sẽ yêu cầu người dùng ứng dụng đăng nhập bằng hồ sơ doanh nghiệp. Hệ thống chỉ yêu cầu bước này nếu cấu hình này cần quyền truy cập liên tục vào tài sản doanh nghiệp, chẳng hạn như Trang Facebook, tài khoản quảng cáo hoặc tài khoản Instagram.
7. Chọn tất cả tài sản mà ứng dụng của bạn cần quyền truy cập.
8. Chọn những quyền mà ứng dụng của bạn cần rồi nhấp vào Tạo.

Bạn sẽ nhận được ID cấu hình để sử dụng trong mã khi gọi hộp thoại đăng nhập.

Tạo cấu hình Quy trình đăng ký nhúng sẵn Nền tảng WhatsApp Business

Để tạo cấu hình Quy trình đăng ký nhúng sẵn WhatsApp, hãy truy cập hướng dẫn về Quy trình đăng ký nhúng sẵn WhatsApp.

Tạo cấu hình API Chuyển đổi dành cho tính năng Nhắn tin cho doanh nghiệp

Để tạo cấu hình API Chuyển đổi dành cho tính năng Nhắn tin cho doanh nghiệp, hãy truy cập hướng dẫn về API Marketing - API Chuyển đổi dành cho tính năng Nhắn tin cho doanh nghiệp.

Tạo cấu hình API Đồ thị trên Instagram

Để tạo cấu hình API Đồ thị trên Instagram, hãy truy cập tài liệu về API Đồ thị trên Instagram.

Gọi hộp thoại đăng nhập

Gọi hộp thoại đăng nhập bằng một trong các SDK của chúng tôi (khuyên dùng) hoặc tạo quy trình đăng nhập theo cách thủ công.

Gọi bằng SDK của chúng tôi

Bạn có thể sử dụng bất kỳ SDK nào của chúng tôi để gọi hộp thoại đăng nhập thông qua việc thay thế danh sách phạm vi (quyền) mà ứng dụng của bạn cần bằng ID cấu hình và loại cấp quyền OAuth bắt buộc của mã truy cập.

Nếu chưa quen dùng SDK của chúng tôi, trước tiên, bạn nên cài đặt JavaScript SDK và để SDK này hoạt động với sản phẩm Đăng nhập bằng Facebook cho người tiêu dùng rồi mới tiếp tục, như các ví dụ tham chiếu đến SDK dưới đây.

Cấu hình mã truy cập dành cho người dùng hệ thống của tiện ích tích hợp cho doanh nghiệp

Sau đây là ví dụ minh họa phương thức FB.login() của JavaScript SDK được sửa đổi để sử dụng cấu hình cho mã truy cập dành cho Người dùng hệ thống. Lưu ý rằng config_id đã thay thế scope (không nên sử dụng), response_type đã được đặt là code vì SUAT yêu cầu loại cấp quyền là mã ủy quyền, đồng thời override_default_response_type phải được đặt là true. Khi có giá trị true, bất kỳ loại phản hồi nào được chuyển qua response_type đều sẽ được ưu tiên hơn các loại mặc định.

FB.login(
  function(response) [
    console.log(response);
  ],
  [
    config_id: '<CONFIG_ID>',
    response_type: 'code',
    override_default_response_type: true
  ]
);

Khi người dùng hoàn tất quy trình của hộp thoại đăng nhập, chúng tôi sẽ chuyển hướng người dùng đó đến URL chuyển hướng của bạn kèm theo một mã. Sau đó, bạn phải đổi mã này lấy mã truy cập bằng cách thực hiện lệnh gọi giữa các máy chủ đến máy chủ của chúng tôi.

GET https://graph.facebook.com/v21.0/oauth/access_token?
  client_id=<APP_ID>
  &client_secret=<APP_SECRET>
  &code=<CODE>

Hãy xem phần Đổi mã lấy mã truy cập để biết thêm thông tin về bước này.

Cấu hình mã truy cập dành cho người dùng

Sau đây là ví dụ minh họa phương thức FB.login() của JavaScript SDK được sửa đổi để sử dụng cấu hình cho mã truy cập dành cho Người dùng. Lưu ý rằng config_id đã thay thế scope (mặc dù bạn vẫn có thể thêm scope nhưng không nên sử dụng).

FB.login(
  function(response) {
    console.log(response);
  },
  {
    config_id: '<CONFIG_ID>' // configuration ID goes here
  }
);

Sau đây là ví dụ minh họa nút đăng nhập của JavaScript SDK được sửa đổi để sử dụng cấu hình cho mã truy cập dành cho Người dùng:

<fb:login-button config_id="<CONFIG_ID>" onlogin="checkLoginState();"></fb:login-button>

Tạo quy trình đăng nhập theo cách thủ công

Hãy xem bài viết Tạo quy trình đăng nhập theo cách thủ công để tìm hiểu cách gọi hộp thoại đăng nhập theo cách thủ công. Khi gọi hộp thoại đăng nhập và đặt URL chuyển hướng, hãy thêm ID cấu hình của bạn làm một thông số không bắt buộc (mặc dù bạn vẫn có thể thêm scope (phạm vi) nhưng không nên sử dụng).

config_id=<CONFIG_ID>

Chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp

Giải pháp Đăng nhập bằng Facebook cho doanh nghiệp có sẵn cho các ứng dụng thuộc loại dành cho Doanh nghiệp.

Nếu ứng dụng của bạn đủ điều kiện chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp, bạn sẽ thấy được biểu ngữ chọn sử dụng sau khi thực hiện các bước dưới đây:

1. Chọn ứng dụng của bạn trong Bảng điều khiển ứng dụng
2. Chuyển đến hoặc thêm sản phẩm Đăng nhập bằng Facebook
3. Nhấp vào mục Cài đặt hoặc Bắt đầu nhanh trong menu bên trái
4. Nhấp vào nút "Bắt đầu dùng sản phẩm Đăng nhập bằng Facebook cho doanh nghiệp" ở đầu trang.

Lưu ý rằng việc chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp sẽ không ảnh hưởng đến mã truy cập hiện tại của bạn. Ngoài ra, (các) ứng dụng thử nghiệm liên kết với ứng dụng này cũng sẽ chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp.

Sau khi chuyển, loại ứng dụng của bạn sẽ thuộc loại dành cho Doanh nghiệp. Nếu ứng dụng của bạn không hoạt động như dự kiến, mỗi ứng dụng sẽ được phép chuyển lại về phương thức Đăng nhập bằng Facebook trong vòng 30 ngày sau khi chuyển.

Khắc phục sự cố

Khách hàng doanh nghiệp có thể gặp thông báo lỗi vì các lý do sau:

• ID cấu hình không hợp lệ
• Thiết bị di động hiện chưa hỗ trợ Mã truy cập dành cho người dùng hệ thống của doanh nghiệp
• Thiết lập sai response_type cho Mã truy cập dành cho người dùng hệ thống của doanh nghiệp

Những thay đổi quan trọng có thể diễn ra:

• Nếu loại ứng dụng của bạn đang là Không có, khi bạn chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp, loại ứng dụng này sẽ chuyển thành Doanh nghiệp và sẽ chỉ sử dụng được các quyền, tính năng và sản phẩm nêu trên.
• Nếu bạn yêu cầu quyền hoặc tính năng từ khách hàng doanh nghiệp mà giải pháp Đăng nhập bằng Facebook cho doanh nghiệp không hỗ trợ, những quyền và tính năng đó sẽ bị thu hồi ngay khi bạn chuyển ứng dụng sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp.
• Nếu bạn chỉ yêu cầu email và/hoặc public_profile từ doanh nghiệp khách hàng, việc chuyển ứng dụng sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp sẽ làm vô hiệu hóa tất cả mã đã cài đặt trước đó dành cho khách hàng này.
• Nếu ứng dụng của bạn có cả giải pháp Đăng nhập bằng Facebook cho doanh nghiệp và Tiện ích Meta Business, trải nghiệm Tiện ích Meta Business sẽ chỉ dùng được các quyền mà giải pháp Đăng nhập bằng Facebook cho doanh nghiệp hỗ trợ.
• Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp có thể ảnh hưởng đến cách truy cập và quản lý dữ liệu trên trang cá nhân của người dùng qua API của chúng tôi.
• Lưu ý: nếu hộp thoại đăng nhập của giải pháp Đăng nhập bằng Facebook cho doanh nghiệp được gọi qua ID cấu hình và nếu bạn quyết định chuyển lại về phương thức Đăng nhập bằng Facebook, hộp thoại đăng nhập có thể không tải được do phương thức Đăng nhập bằng Facebook không hỗ trợ thông số config_id. Trong trường hợp này, bạn cần thay thế thông số config_id bằng thông số scope.

Tìm hiểu thêm về Tiện ích Meta Business.

Chuyển về phương thức Đăng nhập bằng Facebook

Sau khi chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp, nếu ứng dụng của bạn không hoạt động như dự kiến sau khi chuyển sang giải pháp Đăng nhập bằng Facebook cho doanh nghiệp, bạn có thể chuyển lại về phương thức Đăng nhập bằng Facebook thông qua Bảng điều khiển ứng dụng > Đăng nhập bằng Facebook cho doanh nghiệp > Cài đặt rồi nhấp vào liên kết Chuyển sang Đăng nhập bằng Facebook. Bạn sẽ thấy một khảo sát nhằm giúp chúng tôi nâng cao trải nghiệm cấu hình Đăng nhập bằng Facebook cho doanh nghiệp. Mỗi ứng dụng được phép chuyển lại về phương thức Đăng nhập bằng Facebook trong vòng 30 ngày sau khi chuyển.

Câu hỏi thường gặp