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 integrasi Dialogflow Meta Messenger, Anda dapat membuat bot Meta Messenger untuk berinteraksi dengan pengguna akhir.

Catatan: Saat menggunakan integrasi pihak ketiga, permintaan dan data pengguna akhir akan dikirim ke Google dan pihak ketiga. 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.

Cara kerjanya

Catatan: Integrasi ini tidak mendukung Workplace from Meta.

Berikut cara kerja integrasi:

• Anda membuat aplikasi Meta yang menggunakan Platform Meta Messenger.
• Anda perlu mengonfigurasi integrasi Dialogflow dan aplikasi Meta agar saling berkomunikasi.
• Integrasi Dialogflow mengirimkan pesan kepada pengguna akhir menggunakan Meta Messenger API.
• Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Meta Webhooks untuk Platform Messenger.

Penyiapan

Catatan: Pastikan penagihan diaktifkan pada 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 for Messenger Platform untuk menyelesaikan hal berikut:

   • Tambahkan Platform Messenger ke aplikasi Meta Anda.
   • Mendaftarkan 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 akan digunakan untuk mengonfigurasi integrasi dari Konsol Dialogflow.
   • Jangan mengonfigurasi webhook atau menguji integrasi Anda terlebih dahulu.

3. Konfigurasikan integrasi dari Konsol Dialogflow:

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

   5. Dialog konfigurasi akan terbuka:

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

      • Verifikasi token: Anda dapat memasukkan token pribadi apa pun yang diinginkan. Salin nilai ini. Metode ini akan 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.

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

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

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

   • Konfigurasikan webhook Meta untuk aplikasi Anda. Gunakan nilai URL webhook 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 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 (mis., audio, gambar, video, dll.).

Tombol Mulai

Untuk menyiapkan Tombol Mulai Meta Messenger:

1. Alihkan tombol Aktifkan tombol mulai saat mengaktifkan layanan integrasi ini.

   • Layanan integrasi ini akan mengaktifkan tombol untuk Anda dengan memanggil Mesir 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 pada percakapan baru.

2. Mulai percakapan baru dengan halaman Meta Anda.

3. Klik tombol Get Started, dan verifikasi responsnya dari pengendali peristiwa kustom.

Anda dapat memanggil Operator 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 Get Started:

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 multimedia didukung melalui Custom Payload di Fulfillment. Lihat Mengirim Objek Pesan Parameter API untuk mengetahui format pesan.

Misalnya, payload kustom berikut menyediakan pesan teks sederhana:

{
  "text": "Hello, world"
}

Payload kustom berikut menyediakan pesan gambar:

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

Respons khusus channel

Jika dikonfigurasi, respons khusus channel dengan channel DF_CX_FB_MESSENGER akan digunakan secara otomatis saat agen menanggapi pesan Meta Messenger.