Messenger dari Meta

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

Cara kerjanya

Berikut cara kerja integrasi:

  • Anda membuat aplikasi Meta yang menggunakan Meta Messenger Platform.
  • Anda mengonfigurasi Integrasi Dialogflow CX dan aplikasi Meta agar keduanya berkomunikasi satu sama lain.
  • Integrasi Dialogflow CX mengirimkan pesan kepada pengguna Anda menggunakan Meta Messenger API.
  • Integrasi Dialogflow CX menerima pesan dari pengguna Anda dengan bertindak sebagai Webhook Meta untuk Messenger Platform.

Penyiapan

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 Meta Messenger Platform. Ikuti langkah-langkah dalam dokumentasi Webhook Meta untuk Platform Messenger guna menyelesaikan hal berikut:
    • Tambahkan Messenger Platform ke aplikasi Meta Anda.
    • Daftarkan aplikasi Anda ke halaman Meta. Pastikan messages dan messaging_postbacks diaktifkan di langganan halaman.
    • Salin token akses yang diberikan pada langkah ini. Token ini digunakan untuk mengonfigurasi integrasi dari konsol Dialogflow CX.
    • Jangan mengonfigurasi webhook atau menguji integrasi Anda terlebih dahulu.
  3. Konfigurasikan integrasi dari konsol Dialogflow CX:
    1. Buka konsol Dialogflow CX.
    2. Pilih tab Kelola di menu navigasi.
    3. Pilih Integrations.
    4. Klik tombol Connect di kartu Meta Messenger.
    5. Lengkapi kolom dialog konfigurasi:
      • Rahasia aplikasi: Masukkan rahasia aplikasi dari Setelan Dasar Dasbor Aplikasi.
      • Verifikasi token: Masukkan token pribadi yang Anda perlukan. Salin nilai ini. URL ini digunakan untuk mengonfigurasi Webhook Meta Messenger.
      • Token akses halaman: Masukkan token akses yang Anda salin selama penyiapan aplikasi Meta.
      • Enable get started button: Centang kotak ini untuk mengaktifkan Get started button.
      • URL Webhook: Salin nilai ini. URL ini digunakan untuk mengonfigurasi Webhook Meta Messenger.
      • Start: Pilih kotak centang ini untuk memulai layanan integrasi bagi agen Anda.
  4. Selesaikan penyiapan aplikasi Meta dan uji aplikasi tersebut. Ikuti langkah-langkah dalam dokumentasi Webhook Meta untuk Messenger Platform untuk menyelesaikan hal berikut:
    • Konfigurasikan webhook Meta untuk aplikasi Anda. Gunakan nilai URL webhook dan Verify token yang Anda salin sebelumnya. Pastikan untuk mengaktifkan messages dan messaging_postbacks di langganan halaman.
    • Menguji aplikasi Anda.

Acara

Peristiwa berikut dipanggil oleh integrasi ini. Anda dapat membuat pengendali peristiwa kustom untuk menentukan tindakan yang harus 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, atau video).

Tombol Mulai

Siapkan tombol mulai Meta Messenger:

  1. Aktifkan Enable Get Started Button saat mengaktifkan layanan integrasi ini.

    • Layanan integrasi ini memungkinkan Anda mengaktifkan tombol 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 peristiwa FACEBOOK_WELCOME.

Untuk mengujinya:

  1. Hapus percakapan sebelumnya dengan halaman Meta Anda jika ada.
    • Tombol Mulai hanya muncul di percakapan baru.
  2. Mulai percakapan baru dengan halaman Meta Anda.
  3. Klik tombol Get Started, dan verifikasi respons dari pengendali peristiwa kustom.

Anda dapat memanggil Messenger Profile API untuk mengelola tombol Get Started. Hal ini dapat membantu pengujian.

Untuk memeriksa status tombol Mulai, gunakan permintaan berikut:

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

Anda dapat menggunakan permintaan berikut untuk 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 menggunakan Payload Kustom di Fulfillment. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Objek Pesan Parameter Send API untuk format pesan.

Misalnya, payload kustom berikut memberikan pesan teks:

{
  "text": "Hello, world"
}

Payload kustom berikut menyediakan pesan gambar:

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

Respons khusus saluran

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