Tempat Kerja dari Facebook

Dengan 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 saling berkomunikasi.
  • Integrasi Dialogflow mengirim pesan kepada 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 Integrations 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 System Admin di Workplace untuk menginstal integrasi.
      • Klik Tambahkan ke Workspace di jendela pop-up yang meminta Anda menginstal integrasi Dialogflow. Anda juga memiliki opsi untuk 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 mulailah melakukan chat dengan bot.

Batal

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

  1. Buka konsol Dialogflow ES.

  2. Klik Integrations di menu sidebar kiri.

  3. Klik Facebook Workplace:

    1. Jika Anda melihat tombol CANCEL: Klik CANCEL 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 Integrations di menu sidebar kiri.

  3. Klik Facebook Workplace.

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

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

  5. Integrasi Dialogflow akan di-uninstal.

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

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 menggunakan integrasi Messenger dan akan memigrasikannya ke integrasi Workplace, Anda harus:

  1. Hentikan integrasi Messenger.

  2. Hapus callback_url di aplikasi Facebook dengan membatalkan langkah-langkah di Menyiapkan Aplikasi Facebook.

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