Integrasi Google Chat Dialogflow

Dengan mengintegrasikan Dialogflow dengan Google Chat, Anda dapat memanfaatkan fitur di kedua layanan:

  • Google Chat. Menyediakan platform pesan dengan antarmuka pengguna frontend untuk percakapan pribadi dan ruang chat. Melalui Google Chat, Anda dapat meningkatkan kualitas antarmuka pengguna dengan membuat kartu yang menyertakan ikon, gambar, tombol, kolom entri teks, atau aplikasi seperti Google Maps.
  • Dialogflow. Menyediakan platform natural language understanding untuk percakapan otomatis dan respons dinamis. Melalui Dialogflow, Anda dapat menafsirkan dan memenuhi maksud pengguna, misalnya, untuk menjadwalkan janji temu atau memproses pembelian.

Meskipun Anda juga dapat menggunakan Google Chat untuk memenuhi permintaan pengguna, Dialogflow memungkinkan pengguna menyampaikan permintaan mereka melalui percakapan biasa.

Cara kerjanya

Setelah membuat aplikasi Google Chat yang mendukung Dialogflow, Anda dapat menyediakan aplikasi tersebut untuk:

  • Masyarakat umum. Pengguna Google Workspace berlisensi dapat mendownload aplikasi Anda melalui Google Workspace Marketplace.
  • Domain Google Workspace. Administrator Google Workspace dapat menentukan aplikasi mana yang dapat ditambahkan pengguna ke Google Chat.
  • Penguji aplikasi. Saat menguji aplikasi, Anda dapat membatasi akses ke aplikasi.

Di Google Chat, pengguna dapat melakukan percakapan langsung dengan aplikasi Anda atau memanggil aplikasi dari dalam ruang. Hal berikut akan terjadi:

  1. Pengguna mengirim pesan ke aplikasi Chat.
  2. Google Chat mengirim permintaan JSON ke aplikasi Chat, yang dapat dihosting di Cloud Functions.
  3. Aplikasi Chat menerima permintaan JSON, dan menguraikannya. Selama penguraian ini, aplikasi Chat memanggil Dialogflow.
  4. Aplikasi Chat mengirim permintaan ke Dialogflow yang menyertakan teks pesan bahasa alami pengguna.
  5. Dialogflow menafsirkan teks pengguna dan mengirimkan respons ke aplikasi Chat.
  6. Aplikasi Chat mengurai respons Dialogflow dan mengirim respons JSON ke Google Chat.
  7. Google Chat menerima respons JSON aplikasi Chat dan merender respons dalam bentuk pesan teks, pesan kartu, atau pesan dialog di UI.
  8. Google Chat membagikan respons ini apa adanya atau menampilkan respons lengkap menggunakan UI berbasis kartu.

Halaman ini menjelaskan cara mengintegrasikan Dialogflow dengan Google Chat dan mengonfigurasi respons chat kaya.

Batasan

Dengan integrasi Google Chat, agen Dialogflow hanya dapat menggunakan bahasa agen default.

Sebelum memulai

Hanya pengguna Google Workspace berlisensi yang dapat menggunakan aplikasi Google Chat. Administrator Google Workspace Anda harus melakukan hal berikut:

Membangun agen Dialogflow

Jika Anda belum membuat agen Dialogflow, tetapi ingin melihat cara agen berinteraksi dengan Google Chat, ikuti Panduan memulai ini untuk membuat agen sederhana. Namun, jangan hapus agen. Selanjutnya, kita akan menyiapkan agen dengan antarmuka Google Chat.

Menyiapkan Google Chat

Untuk menyiapkan agen Dialogflow dengan Google Chat, Anda dapat menggunakan salah satu cara berikut:

Menyiapkan Google Chat menggunakan konsol Dialogflow

Untuk mengintegrasikan Google Chat menggunakan konsol Dialogflow, ikuti langkah-langkah berikut:

  1. Buka konsol Dialogflow ES.
  2. Di menu kiri, pilih project Dialogflow.
  3. Klik Integrations.
  4. Klik Google Chat. Jika Google Chat tidak ada dalam opsi, lihat Pemecahan masalah.
  5. Pilih siapa saja yang dapat mengakses aplikasi.
  6. [Opsional] Pilih lingkungan untuk menjalankan agen.
  7. Klik Mulai.

Aplikasi Google Chat Anda kini aktif dan tersedia bagi orang-orang yang Anda pilih.

Untuk mengonfigurasi aplikasi, klik Google Chat lagi, lalu KONFIGURASI DETAIL BOT. Tindakan ini akan menampilkan Google Cloud halaman konsol untuk Google Chat API, tempat Anda dapat mengonfigurasi parameter aplikasi seperti avatar aplikasi.

Menyiapkan Google Chat menggunakan konsol Google Cloud

Untuk mengintegrasikan Google Chat menggunakan konsol Google Cloud , ikuti langkah-langkah berikut:

  1. Pilih project Dialogflow.

    Buka pemilih project

  2. Klik .

  3. Klik APIs & Services, lalu Library.

  4. Cari dan klik Google Chat API.

  5. Klik Enable.

  6. Klik tab Configuration.

  7. Konfigurasi aplikasi.

  8. Di panel Visibilitas, pilih siapa yang dapat mengakses aplikasi:

    • Penguji aplikasi. Pilih Jadikan percakapan ini tersedia bagi orang tertentu, lalu masukkan alamat email mereka.
    • Domain Google Workspace Enterprise atau publik. Publikasikan aplikasi.

  9. Klik Simpan. Aplikasi Google Chat Anda kini aktif dan tersedia bagi orang-orang yang Anda pilih.

Uji

Sebelum menguji aplikasi Chat, pastikan Anda telah memulainya, seperti yang dijelaskan dalam Menyiapkan Google Chat.

Anda dapat menguji aplikasi menggunakan salah satu metode berikut:

Melakukan chat langsung dengan aplikasi

  1. Buka Google Chat.
  2. Di panel Chat, klik +, lalu pilih Temukan aplikasi.
  3. Telusuri dan pilih aplikasi Anda. Jika Google Chat tidak mencantumkan aplikasi Anda, lihat Pemecahan masalah.
  4. Klik Chat.
  5. Di kolom entri chat, masukkan frasa bahasa alami untuk menguji aplikasi.

Memanggil aplikasi dari ruang

  1. Buka Google Chat.
  2. Di panel Ruang, klik +, lalu pilih Buat ruang.
  3. Masukkan nama ruang Test.
  4. Klik Buat.
  5. Di kolom entri chat, masukkan @, lalu pilih aplikasi Anda untuk melengkapi nama secara otomatis.
  6. Setelah nama aplikasi yang otomatis dilengkapi, masukkan frasa bahasa alami untuk menguji aplikasi.

Memecahkan masalah

Error Solusi
Halaman Dialogflow ES console > Integrations tidak menampilkan Google Chat sebagai opsi. Coba muat ulang halaman: Di menu sebelah kiri, klik Intents, lalu klik Integrations.
Google Chat tidak mencantumkan aplikasi Anda sebagai tersedia. Pastikan administrator Google Workspace Anda menambahkan akun Google Workspace untuk Anda dan mengizinkan pengguna menginstal aplikasi Chat. Kemudian, pastikan Anda telah memulai aplikasi Chat, seperti yang dijelaskan dalam Menyiapkan Google Chat.

Pesan respons lengkap

Integrasi ini menerjemahkan beberapa pesan respons kaya ke format pesan Google Chat.

Respons Teks

Respons teks dikirim ke Google Chat sebagai Pesan teks. Dengan pemformatan ini, Anda dapat membuat teks menjadi tebal atau miring dengan menyertakan teks dalam simbol tertentu (markdown ringan).

Respons pesan teks, secara visual terlihat sama dengan Respons Teks Default di Konsol Dialogflow. Namun, respons API mentah akan terlihat sedikit berbeda. Selain itu, setelan ini menetapkan konfigurasi platform ke GOOGLE_HANGOUTS, yang mungkin menarik saat membangun agen untuk beberapa integrasi.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Kartu

Respons kartu dikirim ke Google Chat sebagai Pesan kartu.

Gambar

Respons gambar dikirim ke Google Chat sebagai Widget Gambar Google Chat.

Payload Kustom

Untuk mengirim jenis pesan Google Chat lainnya, Anda dapat menggunakan payload kustom.

Payload Kustom Google Chat memungkinkan Anda membuat kartu yang lebih canggih. Satu kartu dapat memiliki satu atau beberapa bagian. Setiap bagian dapat memiliki header. Anda dapat melihat panduan referensi kartu format pesan Google Chat, untuk melihat beberapa kombinasi yang dapat Anda buat dengan fitur ini. Namun, menggunakan payload kustom berarti Anda harus memberikan format JSON.

Berikut adalah contoh payload kustom menggunakan format Kartu v1:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Menghentikan aplikasi Chat

Untuk menghentikan ketersediaan aplikasi Google Chat, Anda dapat menggunakan salah satu cara berikut:

Menghentikan aplikasi Chat menggunakan konsol Dialogflow

  1. Buka konsol Dialogflow ES.
  2. Di menu kiri, pilih project Dialogflow.
  3. Klik Integrations.
  4. Klik Google Chat. Jika Google Chat tidak ada dalam opsi, lihat Pemecahan masalah.
  5. Klik Stop.

Menghentikan aplikasi Chat menggunakan konsol Google Cloud

  1. Pilih project Dialogflow dari konsol Google Cloud .

    Buka pemilih project

  2. Klik .

  3. Klik APIs & Services, lalu Library.

  4. Cari dan klik Google Chat API.

  5. Klik Kelola.

  6. Klik tab Configuration.

  7. Di kolom Status aplikasi, pilih DINONAKTIFKAN.

Informasi selengkapnya

Untuk mengetahui informasi selengkapnya tentang cara menggunakan Google Chat, lihat referensi berikut: