Meta Business Extension

Autentikasi Aplikasi Bisnis


Aplikasi Bisnis, tersedia di seluruh permukaan Facebook, adalah tempat bagi bisnis kecil untuk menemukan dan terhubung ke aplikasi bisnis pihak ketiga agar bisa dengan mudah menyiapkan fitur bisnis berbiaya teknologi rendah guna mengembangkan dan mencapai tujuan bisnis mereka.


Tidak seperti Login Bisnis, karena alur Aplikasi Bisnis diluncurkan dari permukaan kami, ada langkah tambahan yang mengharuskan pengguna untuk masuk ke platform Anda melalui browser pop-up untuk mengautentikasi dan memilih bisnis mereka yang akan dihubungkan (diidentifikasi oleh external_business_id yang Anda definisikan). Jika autentikasi berhasil, pengguna akan dialihkan kembali ke alur untuk menyelesaikan onboarding.

Jika Anda ingin aplikasi Anda ditampilkan di permukaan Aplikasi Bisnis kami, Anda perlu membuat URL autentikasi, endpoint Webhooks, dan menyiapkannya serta memvalidasinya melalui Panel Developer.

Semua aplikasi harus mengajukan Tinjauan Integrasi, setelah integrasi FBE Anda disetujui, aplikasi Anda akan tersedia untuk pengguna publik.

Catatan: Login Bisnis dapat digunakan sebagai alternatif dalam Aplikasi Bisnis untuk autentikasi. Lihat dokumentasi cara menggunakan Login Bisnis.

Penerapan URL Autentikasi

Aplikasi Bisnis meluncurkan alur analog dengan Login Bisnis dari permukaan Halaman Facebook, Instagram, dan Facebook Business Suite. Untuk mengaktifkan alur ini dan membuat aplikasi Anda terdaftar di sana, Anda harus menyediakan UI autentikasi khusus yang memungkinkan pengguna untuk memilih bisnis mereka di situs Anda dan kemudian mengarahkan mereka kembali ke alur Facebook, Instagram, atau Facebook Business Suite.

Cara Kerjanya

  1. Sediakan endpoint URL khusus (URL autentikasi) yang memuat alur autentikasi platform Anda.
    • URL autentikasi Anda harus mengarahkan pengguna (pemilik bisnis) ke alur login di platform Anda.
    • Berikan opsi untuk mendaftarkan akun baru di platform Anda (misalnya: "daftar"). Setelah mendaftar, pengguna harus dikirim kembali ke Facebook untuk menyelesaikan koneksi akunnya.
    • Jika Anda mendukung beberapa bisnis per akun di platform Anda, setelah login berhasil, URL autentikasi akan memunculkan UI kepada pengguna untuk memilih bisnis mana di platform Anda yang ingin mereka kaitkan dengan aset Facebook mereka.
    Contoh — URL Autentikasi 
    https://yourwebsite.com/fbe-auth
  2. Facebook memuat URL autentikasi yang Anda sediakan selama alur onboarding dan menambahkan parameter kueri redirect_uri ke akhir (ini adalah URL pengalihan yang mungkin menyertakan parameter kueri tambahan): 
    https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>
    Contoh—URI pengalihan berenkode yang Anda mungkin lihat ditambahkan di parameter kueri redirect_uri: 
    https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>
    Pada akhir langkah ini, Facebook memuat URL autentikasi Anda dengan parameter kueri redirect_uri tambahan yang mungkin terlihat seperti ini: 
    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

    Catatan penting: Untuk memastikan bahwa Anda tidak membagikan data pengguna dengan pihak lain, hanya alihkan ke redirect_uri jika cocok dengan ekspresi reguler berikut:

    https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?
  3. Setelah pengguna menyelesaikan login/pendaftaran dan memilih bisnis di platform Anda (bila berlaku), alihkan mereka ke URL dari redirect_uri yang telah ditambahi objek ekstra berenkode sebagai parameter kueri (sama seperti yang mungkin Anda gunakan untuk Login Bisnis) dengan business_config dan pengaturan ditentukan di dalamnya (tergantung konfigurasi onboarding yang ingin Anda terapkan): 
    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>

Catatan: Saat memberikan opsi untuk membuat akun baru di URL Autentikasi platform Anda, pastikan bahwa UI yang di-render: 1) ramah perangkat seluler / responsif dan/atau 2) tinggi/lebarnya cukup saat dibuka agar alur pendaftaran partner Anda di-render dengan benar (disarankan dimensi minimal: 600px x 600px).

Autentikasi iframe

Untuk mengaktifkan pengalaman pengguna yang lebih lancar dalam Aplikasi Bisnis dan lebih mendukung pembuatan akun baru di platform Anda, Anda harus mengaktifkan URL autentikasi Anda untuk dimuat dalam iframe di permukaan Facebook. Lihat pedoman penerapan dan spesifikasi setelah pesan di dokumentasi iframe.

Penerapan Webhooks

Webhooks memungkinkan Anda menerima notifikasi HTTP realtime tentang perubahan objek tertentu di Grafik Sosial Facebook. Untuk FBE, ini berarti bahwa setelah pengguna menginstal atau menghapus instalasi FBE menggunakan aplikasi Anda (misalnya melalui Aplikasi Bisnis), Anda akan menerima detail tindakan tersebut melalui Webhooks.

Anda harus membangun endpoint di server aman yang dapat memproses permintaan dari Facebook. Ini wajib bagi semua partner platform yang ingin aplikasinya tersedia di Aplikasi Bisnis. Lihat panduan penerapan Webhooks untuk detail tentang cara membuat endpoint ini.

Pengaturan dan Validasi Webhooks

Setelah endpoint Webhooks Anda siap, pengaturan dan validasinya mengharuskan Anda melakukan:

  1. Gunakan kartu Webhooks di bagian Facebook Business Extension -> Pengaturan pada Dasbor Aplikasi untuk memvalidasi endpoint, dan berlangganan Webhooks fbe_install. Lihat Panduan penerapan Webhooks untuk detail selengkapnya.
  2. Setelah produk Webhooks terkonfigurasi dengan benar, lingkaran di kanan atas kartu seharusnya berubah menjadi hijau dan menunjukkan ikon centang.

Pengaturan dan Validasi melalui Panel Developer

Panel Developer Facebook Business Extension adalah produk di Dasbor Aplikasi Developer Anda. Setelah aplikasi Anda diberikan kemampuan FBE, Anda harus menggunakan Panel Developer untuk menyiapkan dan memvalidasi URL autentikasi Anda, endpoint Webhooks, dan untuk menambahkan detail tentang apa yang ditawarkan aplikasi Anda bagi bisnis.

Pengaturan dan Validasi URL Autentikasi

Setelah URL autentikasi Anda siap, pengaturan dan validasinya mengharuskan Anda melakukan:

  1. Buka Panel Developer FBE di dasbor aplikasi Anda. Catatan: Jika belum mengonfigurasinya, ikuti instruksi ini untuk menambahkannya.
  2. Klik tab Pengaturan dan cari kartu permukaan Aplikasi Bisnis.
  3. Pilih kotak centang Tampilkan aplikasi saya di permukaan Aplikasi Bisnis.
  4. Di input URL Autentikasi, masukkan URL autentikasi Anda.
  5. Klik tombol Uji Autentikasi.
    • Jendela pop-up terbuka dan memuat URL Anda untuk meniru bagaimana Facebook akan menggunakannya di permukaan Aplikasi Bisnis.
    • Lanjutkan dengan login dan pemilihan bisnis (jika ada).
    • Setelah pengalihan, jendela pop-up ditutup. Jika ada kesalahan dalam penerapan Anda (misal: nilai tambahan tidak valid), kesalahan tersebut akan ditampilkan di bagian bawah kartu ini sehingga Anda akan tahu apa yang harus diperbaiki. Fitur Uji Autentikasi hanya akan menvalidasi input pada redirect_uri, dan tidak menginstal FBE.
  6. Setelah langkah penerapan dan konfigurasi tambahan diterapkan seperti yang diharapkan, langkah ini ditandai sebagai valid (centang hijau di pojok kanan atas kartu). Ini akan mengaktifkan kemampuan untuk menguji alur onboarding ini end-to-end (instal FBE) langsung dari Facebook (lihat bagian di bawah).

Pengujian End-to-End

Setelah URL autentikasi dan endpoint Webhooks Anda berhasil disiapkan dan divalidasi di Panel Developer, Anda dapat melakukan pengujian end-to-end untuk alur onboarding, persembahan aplikasi Anda, sebelum aplikasi dialihkan ke mode live. Ini dapat dilakukan langsung dari Facebook Business Suite atau permukaan Halaman Facebook sebagai berikut:

Melalui Facebook Business Suite

  1. Buka Facebook Business Suite.
  2. Di sisi kiri, klik Fitur Lainnya, lalu klik Aplikasi Bisnis.
  3. Semua aplikasi yang tersedia terdaftar di sana. Aplikasi Anda akan dicantumkan di bawah kategori yang Anda pilih sebagai Vertikal pada tab Pengaturan Panel Developer.
  4. Aplikasi Anda akan diberi label Hanya Pengujian - Bukan untuk Publik. Artinya, ini hanya tersedia untuk pengujian bagi pengguna yang memiliki peran dalam aplikasi Anda, bukan untuk pengguna publik.
  5. Klik Hubungkan dan mulai uji pengalaman persembahan URL autentikasi Anda:
    • Alur onboarding melakukan penginstalan FBE real dan akan memicu notifikasi Webhooks.

Melalui Permukaan Halaman Facebook

  1. Buka Halaman Facebook yang akses Administratornya Anda miliki.
  2. Di sisi kiri Halaman Facebook Anda, klik Aplikasi Bisnis.
  3. Semua aplikasi yang tersedia terdaftar di sana. Aplikasi Anda akan dicantumkan di bawah kategori yang Anda pilih sebagai Vertikal pada tab Pengaturan Panel Developer.
  4. Aplikasi Anda akan diberi label Hanya Pengujian - Bukan untuk Publik. Artinya, ini hanya tersedia untuk pengujian bagi pengguna yang memiliki peran dalam aplikasi Anda, bukan untuk pengguna publik.
  5. Klik Hubungkan dan mulai uji pengalaman persembahan URL autentikasi Anda:
    • Alur onboarding melakukan penginstalan FBE real dan akan memicu notifikasi Webhooks.

Pelajari Selengkapnya