Koneksi bot ke Facebook

Artikel
10/24/2023

Anda dapat mengonfigurasi bot Anda untuk berkomunikasi dengan orang-orang melalui Facebook Messenger atau Facebook Workplace. Artikel ini menjelaskan cara membuat aplikasi Facebook menggunakan situs Meta for Developers, menghubungkan bot Anda ke aplikasi Facebook Anda di Azure, dan menguji bot Anda di Facebook.

Artikel ini memperlihatkan cara menambahkan saluran Facebook ke bot Anda melalui portal Azure. Untuk informasi tentang cara menggunakan adaptor saluran kustom, lihat Informasi tambahan.

Prasyarat

Langganan Azure. Jika Anda belum memilikinya, buat akun gratis sebelum memulai.
Bot yang diterbitkan ke Azure yang ingin Anda sambungkan ke Facebook.
Akun Facebook for Developers. Jika Anda tidak memiliki akun, Anda dapat membuatnya di developers.facebook.com.
Halaman Facebook tempat pengguna akan mengakses bot Anda. Jika Anda belum memilikinya, Buat Halaman baru.
Untuk menggunakan Facebook Workplace dengan bot, Anda harus membuat akun Workplace dan integrasi kustom untuk menghubungkan bot.

Pengguna akan mengakses bot Anda dari Halaman Facebook. Untuk menyambungkan bot, Anda akan mengaktifkan Facebook Messenger di Halaman Facebook lalu menyambungkan bot ke Halaman.

Membuat aplikasi Anda

Masuk ke akun Meta for Developers Anda.
Buka Membuat Aplikasi Facebook baru.
Pada halaman Pilih jenis aplikasi, pilih Bisnis lalu Berikutnya.
Pada halaman Berikan informasi dasar, masukkan nama untuk aplikasi Anda dan pilih Buat aplikasi.
- Jika diminta, masukkan kata sandi Anda dan pilih Kirim untuk membuat aplikasi Anda.
- Setelah aplikasi Anda dibuat, situs masuk ke halaman untuk aplikasi Anda.
Perluas Pengaturan dan pilih Dasar.
1. Salin dan simpan ID Aplikasi dan Rahasia Aplikasi.
Sekarang di bawah Pengaturan, pilih Tingkat Lanjut.
1. Di panel yang dihasilkan, gulir ke bawah ke pengaturan Keamanan , dan aktifkan Izinkan Akses API ke pengaturan aplikasi.
2. Pilih Simpan Perubahan.

Aktifkan Messenger

Pilih Dasbor.
Di panel yang dihasilkan, gulir ke bawah ke petak ubin Messenger dan pilih Siapkan.
Situs menambahkan pengaturan Messenger ke aplikasi Anda dan menampilkan halaman pengaturan.

Menambahkan halaman dan menghasilkan token

Di bawah Messenger, pilih Pengaturan.
Gulir ke bawah ke Token Akses dan pilih Tambahkan atau Hapus Halaman.
1. Ketika diminta untuk mengaitkan identitas dengan Messenger, lanjutkan dengan akun Anda saat ini atau masuk ke akun lain.
2. Saat diminta untuk Halaman yang ingin Anda gunakan dengan aplikasi Anda, pilih halaman lalu pilih Berikutnya.
3. Jika diminta untuk mengirimkan permintaan Tinjauan Masuk, tinjau informasi dan pilih Selesai.
4. Jika berhasil, situs menampilkan halaman sukses. Pilih OK untuk melanjutkan.
Halaman yang Anda tambahkan sekarang muncul di daftar Halaman .

Salin dan simpan ID Halaman untuk nanti.
Pilih Hasilkan token untuk Halaman.
1. Situs menampilkan informasi keamanan dan memberi Anda kesempatan untuk menyalin token.
2. Baca dan akui peringatan tersebut.
3. Salin token dan pilih Selesai.

Anda sekarang memiliki informasi aplikasi dan token untuk langkah berikutnya. Biarkan langkah-langkah pengaturan Facebook tertunda. Anda akan memperbaruinya nanti.

Mengonfigurasi bot Anda di Azure

Untuk mengizinkan bot Anda mengirim pesan dan acara lain ke Facebook Messenger, aktifkan integrasi webhook.

Di jendela browser baru, buka portal Azure.
Buka bilah sumber daya Azure Bot untuk bot Anda.
Buka Saluran dan pilih Facebook.
Di Konfigurasikan Saluran Facebook, masukkan informasi Facebook yang Anda salin di langkah-langkah sebelumnya.
1. Masukkan ID Aplikasi Facebook dan Rahasia Aplikasi Facebook Anda.
2. Masukkan ID Halaman dan Token Akses Anda.
3. Salin URL panggilan balik yang dihasilkan dan verifikasi nilai token.
4. Pilih Tambahkan.

Tip

Jika Anda tidak memiliki salinan informasi dari langkah-langkah sebelumnya, Anda dapat mengambilnya untuk situs Meta for Developers.
Jika perlu, buat token web baru untuk halaman tersebut. Untuk petunjuknya, lihat Menambahkan halaman dan menghasilkan token.

Mengaktifkan webhook

Kembali ke pengaturan Facebook untuk menyelesaikan proses konfigurasi.

Di situs Meta for Developers, kembali ke halaman pengaturan Messenger untuk aplikasi Anda.
Di panel yang dihasilkan, gulir ke bawah ke bagian Webhook dan pilih Tambahkan URL Panggilan Balik.
Pada halaman Edit URL Panggilan Balik:
1. Masukkan URL panggilan balik dan verifikasi nilai token yang Anda salin dari portal Azure.
2. Pilih Verifikasi dan simpan.
Halaman yang Anda tambahkan sekarang muncul di daftar Halaman di bawah Webhook.
Pilih Tambahkan langganan untuk Halaman.
1. Pada halaman Edit langganan halaman, pilih bidang langganan berikut ini:
  - Pesan
  - messaging_postbacks
  - messaging_options
  - message_deliveries
2. Pilih Simpan.
Situs menampilkan bidang langganan yang ditambahkan di samping Halaman untuk bot Anda.

Membuat aplikasi Anda menjadi publik

Hingga aplikasi diterbitkan, aplikasi berada dalam Mode Pengembangan. Fungsionalitas Plugin dan API hanya akan berfungsi untuk admin, pengembang, dan penguji.

Hanya pembuat (akun Dev Facebook yang membuat halaman dan bot) yang bisa mendapatkan respons bot. Pengguna Facebook normal tidak dapat melihat halaman atau bot. Berikan peran dev atau test untuk menargetkan pengguna, sehingga mereka juga dapat mengobrol dengan bot.

Pengguna yang akan ditambahkan ke peran penguji harus terlebih dahulu mendaftar di situs Meta for Developers. Peran penguji tidak tersedia untuk pengguna Facebook yang tidak memiliki akun Meta for Developers. Untuk informasi selengkapnya tentang peran aplikasi dan pengguna pengujian, lihat dokumentasi pengembang Meta for Developers.

Kirim untuk ditinjau

Facebook memerlukan URL Kebijakan Privasi dan URL Ketentuan Layanan di halaman pengaturan aplikasi dasarnya. Halaman Kode Etik berisi tautan sumber daya pihak ketiga untuk membantu membuat kebijakan privasi. Halaman Ketentuan Penggunaan berisi contoh istilah untuk membantu membuat dokumen Ketentuan Layanan yang sesuai.

Setelah bot selesai, Facebook memiliki proses peninjauan sendiri untuk aplikasi yang diterbitkan ke Messenger. Bot akan diuji untuk memastikan bot tersebut mematuhi Kebijakan Platform Facebook.

Membuat aplikasi menjadi publik dan menerbitkan Halaman

Setelah peninjauan berhasil, di Dasbor Aplikasi di bawah Tinjauan Aplikasi, atur aplikasi ke Publik. Pastikan Halaman Facebook yang terkait dengan bot ini diterbitkan. Status muncul di pengaturan Halaman.

Mengatur versi API

Jika Anda menerima pemberitahuan dari Facebook tentang penghentian versi tertentu dari Graph API:

Buka Meta untuk Pengembang.
Buka aplikasi yang Anda buat untuk bot Anda.
Di bawah Pengaturan, pilih Tingkat Lanjut.
Pilih Tingkatkan versi API, lalu alihkan Tingkatkan Semua Panggilan ke versi 4.0.

Uji koneksi dengan mengikuti langkah-langkah yang dijelaskan di bagian Uji bot Anda di Facebook .

Menguji bot Anda di Facebook

Anda sekarang dapat menguji apakah bot Anda terhubung ke Facebook dengan benar dengan mengirim pesan melalui Halaman Facebook yang Anda kaitkan dengan aplikasi Facebook baru Anda.

Buka Facebook dan beralih ke profil untuk halaman Anda.
Pilih tindakan lainnya (...), lalu Tambahkan Tombol Tindakan.
1. Dalam dialog Kustomisasi tombol tindakan Anda, pilih Coba dan ikuti instruksinya.
2. Pada halaman Tombol Tindakan di bawah Dapatkan orang untuk menghubungi Anda, pilih Kirim Pesan.
3. Pilih Berikutnya, selesaikan dialog dan simpan perubahan Anda.
Beralih kembali ke profil pribadi Anda.
Buka halaman Anda, dan pilih Pesan untuk menguji koneksi ke bot Anda.

Anda juga dapat menguji fitur ini menggunakan bot sampel untuk adaptor Facebook dengan mengisi file appsettings.json dengan nilai yang sama yang dijelaskan dalam langkah-langkah sebelumnya.

Informasi Tambahan

Lihat sampel Bot Framework C# Facebook-events untuk contoh bot yang mendukung komunikasi Facebook Messenger.

Untuk dokumentasi Facebook Messenger, lihat:

Untuk dokumentasi Facebook Workplace, lihat:

Bagikan melalui