Facebook Login for Business

Facebook Login for Business adalah solusi autentikasi dan otorisasi pilihan bagi penyedia layanan teknologi yang membangun integrasi dengan fitur bisnis Meta untuk membuat solusi marketing, pengiriman pesan, dan penjualan.

Facebook Login for Business memungkinkan Anda membuat pengalaman login di Dasbor Aplikasi Meta berdasarkan kebutuhan aplikasi Anda. Anda dapat menentukan jenis token akses, aset, dan izin yang dibutuhkan aplikasi Anda, dan menyimpannya sebagai sebuah konfigurasi. Selama login, pengguna aplikasi Anda diberikan konfigurasi yang memungkinkan mereka untuk memberi aplikasi Anda akses ke aset bisnis mereka.

Persyaratan

• Aplikasi Meta Anda harus berupa aplikasi jenis bisnis
• Semua izin yang diminta aplikasi Anda saat login harus diberikan oleh pengguna aplikasi Anda atau aplikasi Anda tidak akan diberikan izin apa pun.
• Izin email dan public_profile secara otomatis diberikan ke semua aplikasi, tetapi setidaknya satu izin lain yang didukung harus disertakan untuk setiap penginstalan aplikasi.
• Untuk melayani bisnis yang bukan milik Anda atau bukan Anda kelola, aplikasi Anda harus disetujui untuk Akses Lanjutan melalui Tinjauan Aplikasi Meta
• Aplikasi dengan Akses Lanjutan wajib menjalani Tinjauan Berkelanjutan untuk mempertahankan akses. Namun, aplikasi yang menggunakan Facebook Login for Business telah mengurangi persyaratan untuk tinjauan kepatuhan tertentu yang sedang berlangsung karena aplikasi tersebut terbatas dalam mengakses izin dan fitur bisnis.

Izin yang didukung

Tabel berikut menunjukkan izin yang tersedia untuk Facebook Login for Business.

Fitur yang didukung

Produk yang didukung

Token Akses yang didukung

Anda dapat menggunakan Facebook Login for Business untuk mendapatkan token akses Pengguna Sistem Integrasi Bisnis atau token akses Pengguna.

Token akses pengguna

Token akses pengguna harus digunakan jika aplikasi Anda mengambil tindakan secara realtime, berdasarkan input dari pengguna. Contoh, gunakan token akses pengguna jika aplikasi Anda mengharuskan pengguna untuk memasukkan teks dan mengeklik tombol untuk memposting konten ke Halaman mereka. Token akses pengguna juga harus digunakan jika Anda memerlukan API yang memerlukan izin admin di portofolio bisnis.

Token akses pengguna sistem integrasi bisnis

Token akses pengguna sistem integrasi bisnis harus digunakan jika aplikasi Anda melakukan tindakan terprogram, otomatis pada aset klien bisnis Anda tanpa harus bergantung pada input dari pengguna aplikasi, atau memerlukan autentikasi ulang di masa mendatang. Contoh:

• Panggilan API konversi server-ke-server otomatis per jam
• Mengirim tanggapan otomatis sebagai Halaman Facebook atau portofolio bisnis WhatsApp
• Pembaruan otomatis yang berkelanjutan untuk stok katalog produk
• Pengambilan insight iklan secara otomatis

Persyaratan

Untuk mendapatkan token akses pengguna sistem integrasi bisnis dari klien bisnis Anda:

• Aplikasi Anda hanya dapat meminta login dari tampilan web
• Bisnis yang bergabung dengan aplikasi Anda harus memiliki, atau bersedia membuat portofolio bisnis
• Aplikasi Anda harus dikaitkan dengan portofolio bisnis, yang Anda kontrol sepenuhnya. Ini harus terpisah dari portofolio bisnis milik klien bisnis Anda.

Untuk menguji alur token akses pengguna sistem integrasi bisnis, penguji harus memiliki peran pada aplikasi dan kontrol penuh atas bisnis klien.

Token akses pengguna sistem integrasi bisnis granular

Jika Anda memerlukan penyiapan akses yang berbeda untuk tujuan atau departemen yang berbeda, Anda dapat menggunakan beberapa token akses pengguna sistem integrasi bisnis granular per bisnis klien untuk meningkatkan skalabilitas dan keamanan integrasi Anda.

Token akses granular masih spesifik untuk portofolio bisnis klien. Token ini tidak dapat dibagikan dan dapat diakses di berbagai bisnis klien. Lingkup dan daftar aset token akses granular merupakan subset dari token akses pengguna sistem integrasi bisnis asli.

Untuk mengisolasi potensi insiden keamanan jika token disusupi, hanya bisnis klien tertentu yang akan terkena dampaknya, bukan berdampak pada semua portofolio bisnis di semua bisnis klien.

API Pengelolaan Token Akses Pengguna Sistem Integrasi Bisnis

Ketika bisnis klien menginstal aplikasi melalui Facebook Login for Business dan menghasilkan token akses pengguna sistem integrasi bisnis, token tersebut mencakup ID bisnis klien. ID ini mewakili bisnis klien dan digunakan oleh aplikasi Anda untuk melakukan panggilan API.

Endpoint /<CLIENT_BUSINESS_ID>/system_user_access_tokens memungkinkan Anda untuk mengelola token akses pengguna sistem integrasi bisnis yang ada. Tindakan mencakup:

• Buat token akses pengguna sistem integrasi bisnis granular dari token akses pengguna sistem integrasi bisnis yang ada
• Ambil token akses pengguna sistem integrasi bisnis yang ada

Parameter

Contoh permintaan

Diformat agar mudah dibaca.

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"

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan token akses baru yang akan digunakan dalam panggilan API berikutnya.

{
  "access_token": "<NEW_ACCESS_TOKEN>" 
}

Perbandingan

Pengalaman alur login

Alur login token akses pengguna	Alur login token akses pengguna sistem integrasi bisnis
Ada Masalah Kami mengalami masalah saat memutar video ini. Selengkapnya	Ada Masalah Kami mengalami masalah saat memutar video ini. Selengkapnya

Memulai

Berikut adalah langkah-langkah yang diperlukan untuk menyiapkan Facebook Login for Business jika Anda belum mempunyai aplikasi.

Membuat aplikasi

1. Di Dasbor Aplikasi Meta, buat Aplikasi jenis bisnis.
2. Tambahkan produk Facebook Login for Business.
3. Di menu sebelah kiri pilih Konfigurasi.
4. Anda dapat + Buat konfigurasi untuk membuat konfigurasi atau Buat dari template untuk memilih salah satu konfigurasi yang telah ditetapkan oleh Meta. Anda dapat membuat beberapa konfigurasi dan menampilkannya ke set pengguna yang berbeda.
5. Beri nama konfigurasi Anda
6. Pilih jenis token akses yang ingin Anda minta dari klien bisnis Anda, Token akses Pengguna atau Token akses pengguna sistem dan kedaluwarsa token. Jika Anda memilih Token akses pengguna, maka pengguna aplikasi Anda akan login menggunakan akun Facebook pribadi mereka. Jika Anda memilih Token akses pengguna sistem, pengguna aplikasi Anda akan diminta untuk login menggunakan portofolio bisnis. Ini hanya diperlukan jika konfigurasi ini memerlukan akses berkelanjutan ke aset bisnis, seperti Halaman Facebook, akun iklan, atau akun Instagram.
7. Pilih semua aset yang perlu diakses oleh aplikasi Anda.
8. Pilih izin yang diperlukan aplikasi Anda dan klik Buat.

Anda akan menerima ID Konfigurasi yang akan Anda gunakan dalam kode Anda untuk memanggil dialog login.

Buat konfigurasi Pendaftaran Tersemat Platform WhatsApp Business

Untuk membuat konfigurasi Pendaftaran Tersemat WhatApp, kunjungi Panduan Pendaftaran Tersemat WhatsApp.

Buat Conversions API untuk konfigurasi Pesan Bisnis

Untuk membuat konfigurasi Conversions API untuk Pesan Bisnis, kunjungi halaman panduan Marketing API – Conversions API untuk Pesan Bisnis.

Buat konfigurasi Instagram Graph API

Untuk membuat konfigurasi Instagram Graph API, kunjungi halaman dokumentasi Instagram Graph API kami.

Memanggil dialog login

Panggil dialog login menggunakan salah satu SDK kami (direkomendasikan) atau buat alur login Anda secara manual.

Memanggil dengan SDK kami

Anda dapat menggunakan salah satu SDK kami untuk memanggil dialog login dengan mengganti daftar lingkup (izin) yang dibutuhkan aplikasi Anda dengan ID konfigurasi Anda dan jenis pemberian OAuth yang diperlukan dari token akses.

Jika Anda tidak terbiasa dengan SDK kami, kami sarankan Anda terlebih dahulu menginstal JavaScript SDK dan membuatnya berfungsi dengan produk Facebook Login konsumen sebelum melanjutkan, seperti contoh berikut mengacu pada SDK.

Konfigurasi token akses pengguna sistem integrasi bisnis

Berikut ini contoh metode FB.login() JavaScript SDK yang dimodifikasi untuk menggunakan konfigurasi token akses Pengguna Sistem. Perhatikan bahwa config_id telah menggantikan scope (yang seharusnya tidak digunakan), response_type telah diatur ke code, karena SUAT memerlukan jenis pemberian kode otorisasi, dan override_default_response_type harus diatur ke true. Jika "true", setiap jenis tanggapan yang diteruskan dalam response_type akan diutamakan daripada jenis default.

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

Ketika pengguna menyelesaikan alur dialog login, kami akan mengarahkan pengguna ke URL pengalihan Anda dan menyertakan kode. Anda kemudian harus menukar kode ini untuk token akses dengan melakukan panggilan server-ke-server ke server kami.

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

Lihat Menukar Kode untuk Token Akses untuk informasi selengkapnya tentang langkah ini.

Konfigurasi token akses pengguna

Berikut ini contoh metode FB.login() JavaScript SDK yang dimodifikasi untuk menggunakan konfigurasi token akses Pengguna. Perhatikan bahwa config_id telah menggantikan scope (meskipun scope masih dapat disertakan, kami rekomendasikan untuk tidak menggunakannya).

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

Berikut ini contoh tombol login dari JavaScript SDK yang telah diubah untuk menggunakan konfigurasi token akses Pengguna:

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

Buat alur login manual

Lihat Membuat Alur Login secara Manual untuk mempelajari cara meminta dialog login secara manual. Ketika memanggil dialog login dan mengatur URL pengalihan, sertakan ID konfigurasi Anda sebagai parameter opsional (meskipun lingkup masih dapat disertakan, kami rekomendasikan untuk tidak menggunakannya).

config_id=<CONFIG_ID>

Beralih ke Facebook Login for Business

Facebook Login for Business tersedia untuk aplikasi jenis Bisnis.

Jika aplikasi Anda memenuhi syarat untuk beralih ke Facebook Login for Business, Anda akan dapat melihat banner keikutsertaan dengan langkah-langkah berikut:

1. Pilih aplikasi Anda di Dasbor Aplikasi
2. Buka atau tambahkan produk Facebook Login
3. Klik salah satu dari Pengaturan atau Mulai Cepat di menu sebelah kiri
4. Klik tombol "Mulai dengan Facebook Login for Business" di bagian atas halaman.

Harap diperhatikan bahwa token akses Anda saat ini tidak akan terpengaruh saat beralih ke Facebook Login for Business. Selain itu, aplikasi uji apa pun yang terkait dengan aplikasi ini juga akan beralih ke Facebook Login for Business.

Setelah beralih, jenis aplikasi Anda akan berada di bawah jenis Bisnis. Jika aplikasi Anda tidak berfungsi seperti yang diharapkan, setiap aplikasi diizinkan untuk dikembalikan ke Facebook Login dalam 30 hari setelah beralih.

Pemecahan Masalah

Klien bisnis mungkin akan menemui pesan kesalahan karena alasan berikut:

• ID konfigurasi tidak valid
• Token Akses Pengguna Sistem Bisnis saat ini tidak didukung di perangkat Seluler
• Token Akses Pengguna Sistem Bisnis disiapkan dengan response_type yang salah

Perubahan sela potensial:

• Jika jenis aplikasi Anda saat ini Tidak Ada, beralih ke Facebook Login for Business akan mengubah jenis aplikasi Anda menjadi Bisnis dan hanya akan mempertahankan akses ke izin, fitur dan produk yang tercantum di atas.
• Jika Anda meminta izin atau fitur dari klien bisnis yang tidak didukung oleh Facebook Login for Business, izin dan fitur tersebut akan segera dibatalkan setelah aplikasi Anda dialihkan ke Facebook Login for Business.
• Jika Anda hanya meminta email dan/atau public_profile dari klien bisnis Anda, mengalihkan aplikasi ke Facebook Login for Business akan menyebabkan pembatalan semua token yang telah terinstal sebelumnya untuk klien tersebut.
• Jika aplikasi Anda memiliki Facebook Login for Business dan Meta Business Extension, pengalaman Meta Business Extension akan terbatas pada izin yang didukung oleh Facebook Login for Business.
• Akses Profil Pengguna Aset Bisnis dapat memengaruhi cara data profil pengguna diakses dan dikelola melalui API kami.
• Harap diperhatikan bahwa jika dialog login untuk Facebook Login for Business diminta melalui id konfigurasi, dan jika Anda memutuskan untuk kembali ke Facebook Login, maka dialog login mungkin gagal dimuat karena Facebook Login tidak mendukung parameter config_id dan Anda perlu mengganti parameter config_id dengan parameter scope.

Pelajari selengkapnya tentang Meta Business Extension.

Beralih kembali ke Facebook Login

Setelah beralih ke Facebook Login for Business, jika aplikasi Anda tidak berfungsi sebagaimana mestinya setelah beralih ke Facebook Login for Business, Anda bisa kembali ke Facebook Login dengan membuka Dasbor Aplikasi > Facebook Login for Business > Pengaturan dan mengklik tautan Beralih ke Facebook Login. Anda akan disajikan dengan survei yang membantu kami meningkatkan pengalaman konfigurasi Facebook Login for Business. Setiap aplikasi diizinkan untuk dikembalikan ke Facebook Login dalam 30 hari setelah beralih.

Pertanyaan Umum