Messenger dari Meta

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dengan menggunakan integrasi Meta Messenger, Anda dapat membuat bot Meta Messenger untuk berinteraksi dengan pengguna akhir.

Catatan: Saat menggunakan integrasi pihak ketiga, permintaan dan data pengguna akhir dikirim ke Google dan pihak ketiga tersebut. Persyaratan layanan, SLA, harga, dan kuota untuk edisi agen Anda berlaku untuk penanganan permintaan ini oleh Google. Persyaratan layanan, SLA, harga, dan kuota pihak ketiga berlaku untuk penanganan permintaan ini oleh pihak ketiga tersebut.

Cara kerjanya

Catatan: Integrasi ini tidak mendukung Workplace dari Meta.

Berikut cara kerja integrasi:

• Anda membuat aplikasi Meta yang menggunakan Platform Meta Messenger.
• Anda mengonfigurasi integrasi Dialogflow CX dan aplikasi Meta, sehingga keduanya dapat berkomunikasi satu sama lain.
• Integrasi Dialogflow CX mengirim pesan ke pengguna akhir menggunakan Meta Messenger API.
• Integrasi Dialogflow CX menerima pesan dari pengguna akhir dengan bertindak sebagai the Meta Webhooks untuk Platform Messenger.

Penyiapan

Catatan: Pastikan penagihan diaktifkan di project Anda sebelum menguji integrasi.

Untuk menyiapkan integrasi:

1. Ikuti langkah-langkah untuk membuat aplikasi Meta: Pengembangan Aplikasi Meta.

2. Siapkan aplikasi Meta untuk menggunakan Platform Meta Messenger. Ikuti langkah-langkah dalam dokumentasi Meta Webhooks untuk Platform Messenger untuk melakukan hal berikut:

   • Tambahkan Platform Messenger ke aplikasi Meta Anda.
   • Langganankan aplikasi Anda ke halaman Meta. Pastikan messages dan messaging_postbacks diaktifkan dalam langganan halaman.
   • Anda akan diberikan token akses pada langkah ini. Salin nilai ini. Token ini digunakan untuk mengonfigurasi integrasi dari konsol Dialogflow CX.
   • Jangan konfigurasi webhook atau uji integrasi Anda terlebih dahulu.

3. Konfigurasi integrasi dari konsol Dialogflow CX:

   1. Buka konsol Dialogflow CX.
   2. Klik tab Manage di panel kiri.
   3. Klik Integrations di menu sidebar kiri.
   4. Klik tombol Connect di kartu Meta Messenger.

   5. Dialog konfigurasi akan terbuka:

      • Rahasia aplikasi: Masukkan rahasia aplikasi dari Setelan Dasar Dasbor Aplikasi.

      • Verifikasi token: Anda dapat memasukkan token pribadi apa pun yang diinginkan. Salin nilai ini. Nilai ini digunakan untuk mengonfigurasi Meta Messenger Webhook.

      • Token akses Halaman: Masukkan token akses yang Anda salin selama penyiapan aplikasi Meta di atas.

      • Aktifkan tombol mulai: Lihat bagian Tombol Mulai.

      • URL webhook: Salin nilai ini. Nilai ini digunakan untuk mengonfigurasi Meta Messenger Webhook.

      • Mulai: Klik untuk memulai layanan integrasi ini untuk agen Anda.

4. Selesaikan penyiapan aplikasi Meta dan uji. Ikuti langkah-langkah dalam dokumentasi Meta Webhooks untuk Platform Messenger untuk melakukan hal berikut:

   • Konfigurasi webhook Meta untuk aplikasi Anda. Gunakan nilai URL webhook dan Verify token yang Anda salin di atas. Pastikan untuk mengaktifkan messages dan messaging_postbacks dalam langganan halaman.
   • Uji aplikasi Anda.

Acara

Peristiwa berikut dipanggil oleh integrasi ini. Anda dapat membuat pengendali peristiwa kustom untuk menentukan tindakan yang akan dilakukan saat peristiwa dipicu.

Acara	Deskripsi
FACEBOOK_WELCOME	Dipicu saat pengguna akhir mengklik Tombol Mulai Meta Messenger.
FACEBOOK_MEDIA	Dipicu saat pesan dari pengguna akhir berisi lampiran (misalnya, audio, gambar, video, dll.).

Tombol Mulai

Untuk menyiapkan Tombol Mulai Meta Messenger:

1. Aktifkan Enable get started button saat mengaktifkan layanan integrasi ini.

   • Layanan integrasi ini mengaktifkan tombol untuk Anda dengan memanggil Messenger Profile API.

     curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
     "https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"
     

2. Buat pengendali peristiwa kustom untuk FACEBOOK_WELCOME peristiwa.

Untuk mengujinya:

1. Hapus percakapan sebelumnya dengan halaman Meta Anda (jika ada).

   • Tombol Mulai hanya muncul pada percakapan baru.

2. Mulai percakapan baru dengan halaman Meta Anda.

3. Klik tombol Mulai, lalu verifikasi respons dari pengendali peristiwa kustom.

Anda dapat memanggil Messenger Profile API kapan saja untuk mengelola tombol Mulai. Hal ini mungkin berguna untuk pengujian.

Misalnya, permintaan berikut memeriksa status tombol Mulai:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

Permintaan berikut menonaktifkan tombol Mulai:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Pesan respons lengkap

Pesan respons lengkap didukung melalui Payload Kustom di Fulfillment. Lihat Objek Pesan Parameter Send API untuk mengetahui format pesan.

Misalnya, payload kustom berikut memberikan pesan teks sederhana:

{
  "text": "Hello, world"
}

Payload kustom berikut memberikan pesan gambar:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

Respons khusus saluran

Setelah Anda mengonfigurasi respons khusus saluran, saluran DF_CX_FB_MESSENGER akan otomatis digunakan saat agen merespons pesan Meta Messenger.