Messenger dari Facebook

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Cara kerjanya

Berikut cara kerja integrasi:

  • Anda membuat aplikasi Facebook yang menggunakan platform Facebook Messenger.
  • Anda mengonfigurasi integrasi Dialogflow dan aplikasi Facebook, sehingga keduanya dapat berkomunikasi satu sama lain.
  • Integrasi Dialogflow mengirim pesan kepada pengguna akhir menggunakan Facebook Messenger API.
  • Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Webhook Facebook Messenger.

Penyiapan

Untuk menyiapkan integrasi:

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

  2. Siapkan aplikasi Facebook untuk menggunakan Platform Facebook Messenger. Ikuti langkah-langkah dalam dokumentasi Menyiapkan Aplikasi Facebook untuk melakukan hal berikut:

    • Tambahkan Platform Messenger ke aplikasi Facebook Anda.
    • Berlangganan 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 konfigurasikan webhook atau uji integrasi Anda terlebih dahulu.
  3. Konfigurasikan integrasi dari Konsol Dialogflow:

    1. Buka konsol Dialogflow ES.
    2. Klik Integrations di menu sidebar kiri.
    3. Klik Facebook Messenger.
    4. Dialog konfigurasi akan terbuka:

      • Tampilkan URL callback lama: Jika tombol ini ditampilkan, tombol tersebut akan dinonaktifkan secara default. Ini adalah opsi sementara untuk mengakomodasi perubahan terbaru pada Facebook Messenger API. Jangan ubah tombol ini kecuali jika diinstruksikan oleh dukungan Dialogflow. Setelah semua agen diperbarui, opsi ini akan dihapus.
      • URL Callback: Salin nilai ini. URL ini akan digunakan untuk mengonfigurasi Webhook Facebook Messenger.
      • Verifikasi Token: Anda dapat memasukkan token pribadi yang diinginkan. Salin nilai ini. URL 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.
  4. Selesaikan penyiapan aplikasi Facebook dan uji. Ikuti langkah-langkah dalam dokumentasi Menyiapkan Aplikasi Facebook untuk melakukan hal berikut:

    • Konfigurasikan webhook Facebook untuk aplikasi Anda. Gunakan nilai URL Callback dan Verify Token yang Anda salin 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 lengkap ke jenis pesan Platform Facebook Messenger.

Respons gambar

Respons gambar dikirim ke Facebook Messenger sebagai pesan lampiran file Facebook Messenger. Nilai message.attachment.type ditetapkan 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:

{
  "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"
          }
        }
      }
    }
        
  • Mengirim file:
    {
      "facebook": {
        "attachment": {
          "type": "file",
          "payload": {
            "url": "https://example.com/file.pdf"
          }
        }
      }
    }