Messenger dari Facebook

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Cara kerja Duet AI

Berikut cara kerja integrasi:

  • Anda membuat aplikasi Facebook yang menggunakan platform Facebook Messenger.
  • Anda mengonfigurasi integrasi Dialogflow dan aplikasi Facebook, agar keduanya saling berkomunikasi.
  • Integrasi Dialogflow mengirimkan pesan ke pengguna akhir dengan menggunakan Facebook Messenger API.
  • Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Facebook Messenger Webhook.

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 menyelesaikan hal berikut:

    • Tambahkan Platform Messenger ke aplikasi Facebook Anda.
    • Langgankan 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 mengonfigurasi webhook atau menguji integrasi Anda terlebih dahulu.

  3. Konfigurasikan integrasi dari Konsol Dialogflow:

    1. Buka Dialogflow ES Console.
    2. Klik Integrations di menu sidebar kiri.
    3. Klik Facebook Messenger.

    4. Dialog konfigurasi akan terbuka:

      • Show old callback URL: Jika tombol ini ditampilkan, setelan defaultnya adalah nonaktif. Ini adalah opsi sementara untuk mengakomodasi modifikasi terbaru pada Facebook Messenger API. Jangan ubah tombol ini kecuali diperintahkan oleh dukungan Dialogflow. Setelah semua agen diperbarui, opsi ini akan dihapus.
      • Callback URL: Salin nilai ini. Ini akan digunakan untuk mengonfigurasi Webhook Facebook Messenger.
      • Verify Token: Anda dapat memasukkan token pribadi apa pun yang diinginkan. Salin nilai ini. 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 menyelesaikan hal berikut:

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

Respons gambar

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

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