Messenger dari Facebook

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

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 Anda untuk melakukan hal berikut:

    • Tambahkan Messenger Platform ke aplikasi Facebook Anda.
    • Mendaftarkan aplikasi Anda ke halaman Facebook. Anda akan diberi token akses pada langkah ini. Salin nilai ini. Token ini digunakan untuk mengonfigurasi integrasi dari Konsol Dialogflow.
    • Jangan mengonfigurasi webhook atau menguji integrasi Anda terlebih dahulu.

  3. Mengonfigurasi integrasi dari Konsol Dialogflow:

    1. Buka konsol Dialogflow ES.
    2. Klik Integrasi di menu sidebar kiri.
    3. Klik Facebook Messenger.

    4. Dialog konfigurasi akan terbuka:

      • Tampilkan URL callback lama: Jika tombol ini ditampilkan, tombol ini akan dinonaktifkan secara default. Ini adalah opsi sementara untuk mengakomodasi modifikasi terbaru pada Facebook Messenger API. Jangan ubah tombol ini kecuali jika diinstruksikan oleh dukungan Dialogflow. Setelah semua agen diupdate, opsi ini akan dihapus.
      • URL Callback: Salin nilai ini. Ini digunakan untuk mengonfigurasi Webhook Facebook Messenger.
      • Verifikasi Token: Anda dapat memasukkan token pribadi yang diperlukan. Salin nilai ini. Ini digunakan untuk mengonfigurasi Webhook Facebook Messenger.
      • Token Akses Halaman: 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 Anda untuk melakukan hal berikut:

    • Konfigurasi webhook Facebook untuk aplikasi Anda. Gunakan nilai Callback URL dan Verify Token yang Anda salin di atas. Pastikan untuk mengaktifkan messages dan messaging_postbacks.
    • Uji aplikasi Anda.

Acara

Peristiwa berikut dipicu oleh integrasi ini:

Acara Deskripsi
FACEBOOK_WELCOME Dipicu saat pengguna akhir memulai percakapan dengan bot Anda.

Pesan respons lengkap

Integrasi ini menerjemahkan beberapa pesan respons multimedia 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 pengganti message, berikan objek message Facebook Messenger. Untuk mengetahui detail objek message, lihat referensi Facebook Messenger API.

Contoh:

  • Kirim link audio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Kirim 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"
      }
    }
  }
}