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 front-end untuk percakapan pribadi dan ruang chat. Melalui Google Chat, Anda dapat meningkatkan antarmuka pengguna dengan membuat kartu yang menggabungkan 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 intent pengguna, misalnya, untuk menjadwalkan janji temu atau memproses pembelian.

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

Cara kerja Duet AI

Setelah membangun aplikasi Google Chat yang mendukung Dialogflow, Anda dapat menyediakan aplikasi untuk hal berikut:

• 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 mengirimkan permintaan JSON ke aplikasi Chat, yang dapat dihosting di Cloud Functions.
3. Aplikasi Chat menerima permintaan JSON dan mengurainya. Selama penguraian ini, aplikasi Chat memanggil Dialogflow.
4. Aplikasi Chat mengirimkan 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 mengirimkan 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 yang kaya.

Catatan: Google Chat sebelumnya disebut Hangouts Chat, dan aplikasi Chat sebelumnya disebut bot Chat. Meskipun Google Chat dan konsol Google Cloud menggunakan istilah aplikasi, konsol Dialogflow masih menggunakan istilah bot.

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:

• Tambahkan akun Google Workspace untuk Anda.
• Izinkan pengguna untuk menginstal aplikasi Chat.

Membangun agen Dialogflow

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

Menyiapkan Google Chat

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

• Konsol Dialogflow
• Google Cloud console

Menyiapkan Google Chat menggunakan konsol Dialogflow

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

1. Buka Dialogflow ES Console.
2. Di menu sebelah kiri, pilih project Dialogflow.
3. Klik Integrations.
4. Klik Google Chat. Jika Google Chat bukan salah satu opsi yang tersedia, lihat Memecahkan masalah.
5. Pilih siapa saja yang dapat mengakses aplikasi.
6. [Opsional] Pilih lingkungan untuk menjalankan agen.
7. Klik Start.

Aplikasi Google Chat Anda kini sudah aktif dan tersedia untuk orang yang Anda pilih.

Untuk mengonfigurasi aplikasi, klik Google Chat lagi, lalu KONFIGURASI DETAIL BOT. Tindakan ini akan menampilkan halaman Google Cloud Console 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 API & Layanan, lalu Library.

4. Cari dan klik Google Chat API.

5. Klik Enable.

6. Klik tab Configuration.

7. Mengonfigurasi aplikasi.

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

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

9. Klik Simpan. Aplikasi Google Chat Anda kini sudah aktif dan tersedia untuk orang yang Anda pilih.

Tes

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

Anda dapat menguji aplikasi menggunakan salah satu metode ini:

• Chat langsung dengan aplikasi
• Memanggil aplikasi dari ruang

Chat langsung dengan aplikasi

1. Buka Google Chat.
2. Di panel Chat, klik + lalu pilih Find apps.
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 Spaces, klik +, lalu pilih Create a space.
3. Masukkan nama ruang Test.
4. Klik Create.
5. Di kolom entri chat, masukkan @, lalu pilih aplikasi Anda untuk melengkapi nama secara otomatis.
6. Setelah nama aplikasi terisi secara otomatis, 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 kiri, klik Intent, lalu klik Integrasi.
Google Chat tidak mencantumkan aplikasi Anda sebagai tersedia.	Pastikan administrator Google Workspace 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 pesan respons yang 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 membungkus teks dalam simbol tertentu (lampu markdown).

Respons pesan teks secara visual terlihat sama dengan Respons Teks Default di Konsol Dialogflow. Namun, respons API mentah akan terlihat sedikit berbeda. Tindakan ini juga menetapkan konfigurasi platform ke GOOGLE_HANGOUTS, yang bisa menarik saat mem-build agen untuk beberapa integrasi.

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

{i>Cards<i} (Kartu)

Respons kartu dikirim ke Google Chat sebagai Pesan kartu.

Image

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

Payload Kustom

Catatan: Integrasi ini tidak mendukung tindakan kartu.

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 mengetahui beberapa kombinasi yang dapat dibuat dengan panduan ini. Namun, menggunakan payload kustom berarti Anda harus menyediakan format JSON.

Catatan: Saat Anda menyalin dan menempelkan contoh dari panduan referensi ke kotak payload kustom di Dialogflow, pastikan editor tidak berisi error lint apa pun. Anda tidak dapat menguji hasilnya di Simulator Dialogflow, tetapi dapat mengujinya langsung di Google Chat.

Berikut adalah contoh payload kustom yang menggunakan format Card v1:

Catatan: Format Card v2 tidak didukung.

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "[e-mail]",
      "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:

• Konsol Dialogflow

• Google Cloud console

Menghentikan aplikasi Chat menggunakan konsol Dialogflow

1. Buka Dialogflow ES Console.
2. Di menu sebelah kiri, pilih project Dialogflow.
3. Klik Integrations.
4. Klik Google Chat. Jika Google Chat bukan salah satu opsi yang tersedia, lihat Memecahkan 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 API & Layanan, lalu Library.

4. Cari dan klik Google Chat API.

5. Klik Manage.

6. Klik tab Configuration.

7. Di kolom Status aplikasi, pilih NONAKTIF.

Informasi selengkapnya

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

• Dokumen developer Google Chat
• Mem-build aplikasi Chat
• Video: Mengintegrasikan Dialogflow dengan Google Chat
• Codelab: Mengintegrasikan Dialogflow dengan Google Chat