Dengan integrasi Facebook Messenger di Dialogflow, Anda dapat membuat bot Facebook Messenger untuk berinteraksi dengan pengguna akhir.
Batasan
Hanya bahasa agen default yang didukung oleh integrasi ini.
Cara kerja Duet AI
Berikut cara kerja integrasi:
- Anda membuat aplikasi Facebook yang menggunakan platform Facebook Messenger.
- Anda mengonfigurasi integrasi Dialogflow dan aplikasi Facebook, agar keduanya saling berkomunikasi.
- Integrasi Dialogflow mengirimkan pesan ke pengguna akhir dengan menggunakan Facebook Messenger API.
- Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Facebook Messenger Webhook.
Penyiapan
Untuk menyiapkan integrasi:
Ikuti langkah-langkah untuk membuat aplikasi Facebook: Pengembangan Aplikasi Facebook.
Siapkan aplikasi Facebook untuk menggunakan Platform Facebook Messenger. Ikuti langkah-langkah dalam dokumentasi Menyiapkan Aplikasi Facebook untuk menyelesaikan hal berikut:
- Tambahkan Platform Messenger ke aplikasi Facebook Anda.
- Langgankan aplikasi Anda ke halaman Facebook. Anda akan diberi token akses pada langkah ini. Salin nilai ini. Token ini akan digunakan untuk mengonfigurasi integrasi dari Konsol Dialogflow.
- Jangan mengonfigurasi webhook atau menguji integrasi Anda terlebih dahulu.
Konfigurasikan integrasi dari Konsol Dialogflow:
- Buka Dialogflow ES Console.
- Klik Integrations di menu sidebar kiri.
- Klik Facebook Messenger.
Dialog konfigurasi akan terbuka:
- Show old callback URL: Jika tombol ini ditampilkan, setelan defaultnya adalah nonaktif. Ini adalah opsi sementara untuk mengakomodasi modifikasi terbaru pada Facebook Messenger API. Jangan ubah tombol ini kecuali diperintahkan oleh dukungan Dialogflow. Setelah semua agen diperbarui, opsi ini akan dihapus.
- Callback URL: Salin nilai ini. Ini akan digunakan untuk mengonfigurasi Webhook Facebook Messenger.
- Verify Token: Anda dapat memasukkan token pribadi apa pun yang diinginkan. Salin nilai ini. Ini akan digunakan untuk mengonfigurasi Webhook Facebook Messenger.
- Page Access Token: Masukkan token akses yang Anda salin saat membuat halaman Facebook.
- Mulai: Klik untuk memulai layanan integrasi ini untuk agen Anda.
Selesaikan penyiapan aplikasi Facebook dan uji. Ikuti langkah-langkah dalam dokumentasi Menyiapkan Aplikasi Facebook untuk menyelesaikan hal berikut:
- Konfigurasikan webhook Facebook untuk aplikasi Anda. Gunakan nilai Callback URL dan Verify Token yang disalin di atas. Pastikan untuk mengaktifkan messages dan messaging_postbacks.
- Uji aplikasi Anda.
Acara
Peristiwa berikut dipanggil oleh integrasi ini:
Acara | Deskripsi |
---|---|
FACEBOOK_WELCOME |
Dipicu saat pengguna akhir memulai percakapan dengan bot Anda. |
Pesan respons lengkap
Integrasi ini menerjemahkan beberapa pesan pesan respons yang kaya menjadi jenis pesan Facebook Messenger Platform.
Respons gambar
Respons gambar
dikirim ke Facebook Messenger sebagai
pesan lampiran file Facebook Messenger.
Nilai message.attachment.type
disetel ke image
.
Format berikut didukung:
- jpg
- png
- gif statis
- gif animasi
Respons kartu
Respons kartu dikirim ke Facebook Messenger sebagai template umum Facebook Messenger.
Respons balasan cepat
Respons balasan cepat dikirim ke Facebook Messenger sebagai balasan cepat Facebook Messenger.
Respons payload kustom
Untuk mengirim jenis pesan Facebook Messenger lainnya, Anda dapat menggunakan payload kustom.
Format umum payload kustom terlihat seperti berikut:
{ "facebook": { message } }
Sebagai ganti message
, berikan objek message
Facebook Messenger.
Untuk mengetahui detail objek message
, lihat referensi Facebook Messenger API.
Contoh:
-
Mengirim link audio:
{ "facebook": { "attachment": { "type": "audio", "payload": { "url": "https://example.com/audio/test.mp3" } } } }
-
Mengirim video yang dapat diputar:
{ "facebook": { "attachment": { "type": "video", "payload": { "url": "https://example.com/video.mp4" } } } }
-
Kirim file:
{ "facebook": { "attachment": { "type": "file", "payload": { "url": "https://example.com/file.pdf" } } } }