Messenger dari Facebook

Integrasi Facebook Messenger Dialogflow memungkinkan Anda membuat bot Facebook Messenger untuk berinteraksi dengan pengguna akhir.

Batasan

Integrasi ini hanya mendukung bahasa agen default.

Cara kerjanya

Integrasi berfungsi sebagai berikut:

  1. Buat aplikasi Facebook yang menggunakan platform Facebook Messenger.
  2. Konfigurasi integrasi Dialogflow dan aplikasi Facebook agar keduanya dapat berkomunikasi satu sama lain.
  3. Integrasi Dialogflow mengirim pesan ke pengguna akhir menggunakan Facebook Messenger API.
  4. 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.
    • Langganan aplikasi Anda ke halaman Facebook. Anda akan mendapatkan token akses pada langkah ini. Salin nilai ini. Token ini digunakan untuk mengonfigurasi integrasi dari konsol Dialogflow.
    • Jangan konfigurasi webhook atau uji integrasi Anda terlebih dahulu.

  3. Konfigurasi integrasi dari konsol Dialogflow:

    1. Buka konsol Dialogflow ES.
    2. Klik Integrations di menu sidebar.
    3. Klik Facebook Messenger.
    4. Dialog konfigurasi akan terbuka:
      • Show old callback URL: Jika tombol ini ditampilkan, tombol ini akan nonaktif 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 diperbarui, opsi ini akan dihapus.
      • Callback URL: Salin nilai ini. Nilai ini digunakan untuk mengonfigurasi webhook Facebook Messenger.
      • Verify Token: Anda dapat memasukkan token pribadi yang diperlukan. Salin nilai ini. Nilai ini digunakan untuk mengonfigurasi webhook Facebook Messenger.
      • Page Access Token: Masukkan token akses yang Anda salin saat membuat halaman Facebook.
      • Start: 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:

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

Acara

Peristiwa berikut dipanggil oleh integrasi ini:

  • FACEBOOK_WELCOME: Dipicu saat pengguna akhir memulai percakapan dengan bot Anda.

Pesan respons lengkap

Integrasi ini menerjemahkan beberapa pesan respons lengkap pesan 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 a payload kustom.

Format umum payload kustom terlihat seperti berikut:

{
  "facebook": {
    message
  }
}

Sebagai pengganti message, berikan objek message Facebook Messenger. Untuk mengetahui detail objek message, lihat referensi API Facebook Messenger.

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"
      }
    }
  }
}