Tempat Kerja dari Facebook

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Cara kerjanya

Berikut cara kerja integrasi:

  • Anda mengonfigurasi integrasi Dialogflow dan instance Workplace, sehingga keduanya dapat berkomunikasi satu sama lain.
  • Integrasi Dialogflow mengirim pesan ke pengguna akhir menggunakan Messenger API dari Facebook.
  • Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Webhook Workplace dari Facebook.

Mulai

Untuk memulai integrasi:

  1. Daftarkan instance Workplace jika Anda belum memilikinya, dan pastikan Anda adalah Admin Sistem grup.

  2. Aktifkan integrasi dari Konsol Dialogflow:

    1. Buka konsol Dialogflow ES.
    2. Klik Integrasi di menu sidebar kiri.
    3. Klik Workplace dari Facebook.
    4. Klik MULAI dan Anda akan dialihkan ke Workplace untuk menyelesaikan penginstalan:
      • Login ke akun Workplace Anda. Akun tersebut harus memiliki peran Admin Sistem di Workplace untuk menginstal integrasi.
      • Klik Tambahkan ke Workplace di jendela pop-up yang meminta Anda menginstal integrasi Dialogflow. Anda juga dapat menyesuaikan nama bot.

  3. Uji aplikasi Anda:

    1. Buka Workplace dan login ke akun.
    2. Temukan Dialogflow (atau nama bot yang disesuaikan) di Bot dari bagian Beranda di sidebar dan mulai chat dengan bot.

Batal

Jika Anda mengklik tombol MULAI, tetapi tidak ingin menyelesaikan penginstalan di Workplace:

  1. Buka konsol Dialogflow ES.

  2. Klik Integrasi di menu sidebar kiri.

  3. Klik Workplace Facebook:

    1. Jika Anda melihat tombol BATAL: Klik BATAL untuk membatalkan penginstalan.
    2. Jika Anda melihat tombol HENTIKAN: Ikuti petunjuk di bawah untuk meng-uninstal integrasi.

Hentikan

Untuk menghentikan integrasi yang berhasil diinstal:

  1. Buka konsol Dialogflow ES.

  2. Klik Integrasi di menu sidebar kiri.

  3. Klik Workplace Facebook.

  4. Klik HENTIKAN dan Anda akan dialihkan ke Workplace untuk menyelesaikan penginstalan:

    1. Login ke akun Workplace Anda. Akun tersebut harus memiliki peran Admin Sistem di Workplace untuk meng-uninstal integrasi.
    2. Temukan dan pilih integrasi Dialogflow dari integrasi yang diinstal di Workplace, klik Uninstal untuk menyelesaikan uninstal.

  5. Integrasi Dialogflow akan di-uninstal.

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 payload kustom.

Format umum payload kustom terlihat seperti ini:

{
  "facebook": {
    message
  }
}

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

Batasan

  1. Agen Dialogflow hanya dapat diinstal di satu instance Workplace, tetapi Anda dapat menginstal beberapa agen Dialogflow di satu instance Workplace.

  2. Untuk menghapus penginstalan yang gagal, Anda harus membatalkan penginstalan di Dialogflow dan menghapus penginstalan di Workplace.

Migrasi

Jika Anda menggunakan integrasi Messenger dan akan memigrasikannya ke integrasi Workplace, Anda harus:

  1. Menghentikan integrasi Messenger.

  2. Menghapus callback_url di aplikasi Facebook dengan membalikkan langkah-langkah di Menyiapkan Aplikasi Facebook.

  3. Memulai integrasi Workplace dengan mengikuti langkah-langkah di atas.