Workplace dari Facebook

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

Batasan

Hanya bahasa agen default yang didukung oleh integrasi ini.

Cara kerja Duet AI

Berikut cara kerja integrasi:

  • Anda mengonfigurasi integrasi Dialogflow dan instance Workspace, sehingga keduanya saling berkomunikasi.
  • Integrasi Dialogflow mengirimkan pesan ke pengguna akhir dengan menggunakan Messenger API dari Facebook.
  • Integrasi Dialogflow menerima pesan dari pengguna akhir dengan bertindak sebagai Workplace Webhook 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 Dialogflow ES Console.
    2. Klik Integrations di menu sidebar kiri.
    3. Klik Tempat Kerja dari Facebook.
    4. Klik MULAI dan Anda akan dialihkan ke Workplace untuk menyelesaikan penginstalan:
      • Login ke akun Workplace Anda. Akun harus merupakan Admin Sistem di Workplace agar dapat menginstal integrasi.
      • Klik Add to Workplace di jendela pop-up yang meminta Anda untuk menginstal integrasi Dialogflow. Anda juga memiliki opsi untuk menyesuaikan nama bot.

  3. Uji aplikasi Anda:

    1. Buka Workplace, lalu login ke akun.
    2. Cari Dialogflow (atau nama bot yang disesuaikan) di Bot dari bagian Home pada sidebar dan mulailah melakukan chat dengan bot.

Batal

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

  1. Buka Dialogflow ES Console.

  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 BERHENTI: Ikuti petunjuk di bawah untuk meng-uninstal integrasi.

Hentikan

Untuk menghentikan integrasi yang berhasil diinstal:

  1. Buka Dialogflow ES Console.

  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 harus menjadi Admin Sistem di Workplace untuk meng-uninstal integrasi.
    2. Temukan dan pilih integrasi Dialogflow dari integrasi yang terinstal di Workspace, klik Uninstall untuk menyelesaikan uninstal.

  5. Integrasi Dialogflow akan di-uninstal.

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

Batasan

  1. Agen Dialogflow hanya dapat diinstal pada 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 kembali ke langkah-langkah di Menyiapkan Aplikasi Facebook.

  3. Mulai integrasi Tempat Kerja dengan mengikuti langkah-langkah di atas.