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 antarmuka pengguna dengan membuat kartu yang menggabungkan ikon, gambar, tombol, kolom entri teks, atau aplikasi seperti Google Maps.
• Dialogflow. Menyediakan platform pemahaman bahasa alami 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 menyampaikan permintaan mereka melalui percakapan biasa.

Cara kerjanya

Setelah mem-build aplikasi Google Chat yang mengaktifkan 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 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 mengurainya. 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 mengirim 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 yang kaya 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:

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

Membuat agen Dialogflow

Jika Anda belum membuat agen Dialogflow, tetapi ingin melihat cara agen berinteraksi dengan Google Chat, ikuti Panduan Manual 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 opsi berikut:

• Konsol Dialogflow
• Konsol Google Cloud

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 Integrasi.
4. Klik Google Chat. Jika Google Chat bukan salah satu opsi, lihat Memecahkan 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 untuk orang yang Anda pilih.

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

5. Klik Aktifkan.

6. Klik tab Configuration.

7. Konfigurasikan aplikasi.

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

   • Penguji aplikasi. Pilih Buat 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 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 berikut:

• Melakukan chat langsung dengan aplikasi
• Memanggil aplikasi dari ruang

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 Memecahkan 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 Pengujian.
4. Klik Create.
5. Di kolom entri chat, masukkan @, lalu pilih aplikasi Anda untuk menyelesaikan nama secara otomatis.
6. Setelah nama aplikasi yang dilengkapi secara otomatis, masukkan frasa bahasa alami untuk menguji aplikasi.

Memecahkan masalah

Error	Solusi
Halaman konsol Dialogflow ES > Integrasi tidak menampilkan Google Chat sebagai opsi.	Coba muat ulang halaman: Di menu 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 pesan respons lengkap ke format pesan Google Chat.

Respons Teks

Respons teks dikirim ke Google Chat sebagai Pesan teks. Dengan format ini, Anda dapat membuat teks tebal atau miring dengan menggabungkan teks dalam simbol tertentu (markdown light).

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 mungkin menarik saat mem-build agen untuk beberapa integrasi.

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

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 melihat beberapa kombinasi yang dapat Anda buat dengan ini. Namun, menggunakan payload kustom berarti Anda harus memberikan format JSON.

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

Berikut adalah contoh payload kustom yang menggunakan format Kartu v1:

{
  "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 opsi berikut:

• Konsol Dialogflow

• Konsol Google Cloud

Menghentikan aplikasi Chat menggunakan konsol Dialogflow

1. Buka konsol Dialogflow ES.
2. Di menu kiri, pilih project Dialogflow.
3. Klik Integrasi.
4. Klik Google Chat. Jika Google Chat bukan salah satu opsi, 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. Telusuri dan klik Google Chat API.

5. Klik Kelola.

6. Klik tab Configuration.

7. Di kolom Status aplikasi, pilih DINONAKTIFKAN.

Informasi selengkapnya

Untuk 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