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 pemahaman bahasa alami 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:

  • Publik. 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. Berikut yang 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 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 lengkap.

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:

Membuat 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 tersebut. Selanjutnya, kita akan menyiapkan agen dengan antarmuka Google Chat.

Menyiapkan Google Chat

Untuk menyiapkan agen Dialogflow dengan Google Chat, Anda dapat menggunakan salah satu hal 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 sebelah kiri, pilih project Dialogflow.
  3. Klik Integrations.
  4. Klik Google Chat. Jika Google Chat tidak ada dalam opsi, 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 aktif dan tersedia untuk orang yang Anda pilih.

Untuk mengonfigurasi aplikasi, klik Google Chat lagi, lalu CONFIGURE BOT DETAILS. 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 Google Cloud konsol

Untuk mengintegrasikan Google Chat menggunakan Google Cloud konsol, 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 Visibility, pilih siapa saja yang dapat mengakses aplikasi:

    • Penguji aplikasi. Pilih Make this chat available to specific people dan masukkan alamat email mereka.
    • Publik atau domain Google Workspace Enterprise. Publikasikan aplikasi.

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

Pengujian

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

Anda dapat menguji aplikasi menggunakan salah satu metode berikut:

Chat langsung dengan aplikasi

  1. Buka Google Chat.
  2. Di panel Chat , klik + , lalu pilih Find apps.
  3. Cari 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 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 yang dilengkapi secara otomatis, masukkan frasa bahasa alami untuk menguji aplikasi.

Memecahkan masalah

Error Solusi
Halaman konsol Dialogflow ES > 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 lengkap pesan 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. Respons ini juga menetapkan konfigurasi platform ke GOOGLE_HANGOUTS, yang mungkin menarik saat membuat 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 menyediakan 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 hal berikut:

Menghentikan aplikasi Chat menggunakan konsol Dialogflow

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

Menghentikan aplikasi Chat menggunakan Google Cloud konsol

  1. Pilih project Dialogflow dari Google Cloud konsol.

    Buka pemilih project

  2. Klik .

  3. Klik APIs &Services, lalu Library.

  4. Cari dan klik Google Chat API.

  5. Klik Manage.

  6. Klik tab Configuration.

  7. Di kolom App status, pilih DISABLED.

Informasi selengkapnya

Untuk mengetahui informasi selengkapnya tentang penggunaan Google Chat, lihat hal berikut: