Messenger dari Meta

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

Cara kerjanya

Berikut cara kerja integrasi:

  • Anda membuat aplikasi Meta yang menggunakan Meta Messenger Platform.
  • Anda mengonfigurasi integrasi Agen Percakapan (Dialogflow CX) dan aplikasi Meta, sehingga keduanya dapat saling berkomunikasi.
  • Integrasi Agen Percakapan (Dialogflow CX) mengirim pesan ke pengguna akhir menggunakan Meta Messenger API.
  • Integrasi Agen Percakapan (Dialogflow CX) menerima pesan dari pengguna akhir dengan bertindak sebagai Webhook Meta untuk Platform Messenger.

Penyiapan

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.
    • Berlangganan aplikasi Anda ke halaman Meta. Pastikan messages dan messaging_postbacks diaktifkan di langganan halaman.
    • Anda akan diberi token akses pada langkah ini. Salin nilai ini. Token ini digunakan untuk mengonfigurasi integrasi dari konsol Agen Percakapan (Dialogflow CX).
    • Jangan konfigurasikan webhook atau uji integrasi Anda terlebih dahulu.

  3. Konfigurasikan integrasi dari konsol Agen Percakapan (Dialogflow CX):

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

    5. Dialog konfigurasi akan terbuka:

      • App secret: Masukkan secret aplikasi dari App Dashboard Basic Settings.

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

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

      • Mengaktifkan tombol mulai: Lihat bagian Tombol mulai.

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

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

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

    • Konfigurasikan webhook Meta untuk aplikasi Anda. Gunakan nilai Webhook URL dan Verifikasi token yang Anda salin di atas. Pastikan untuk mengaktifkan messages dan messaging_postbacks di langganan halaman.
    • Uji aplikasi Anda.

Acara

Peristiwa berikut dipanggil oleh integrasi ini. Anda dapat membuat pengelola 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. Alihkan Aktifkan tombol mulai 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 penangan 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 Mulai, dan verifikasi respons dari pengendali peristiwa kustom.

Anda selalu dapat memanggil Messenger Profile API 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 Mengirim Objek Pesan Parameter 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 channel

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