Google Chat

Integrasi Google Chat untuk Dialogflow CX memungkinkan Anda membuat aplikasi Chat Google dengan natural language understanding berdasarkan teknologi Dialogflow CX.

Batasan

Menyiapkan Google Chat

Untuk menyiapkan integrasi Google Chat bagi agen, Anda memerlukan hal berikut:

Mengaktifkan Google Chat API

Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.

  1. Di https://console.cloud.google.com/, aktifkan Google Chat API dan Dialogflow API.
  2. Pastikan Anda mengaktifkan API di project Cloud yang benar, lalu klik Next.
  3. Pastikan Anda mengaktifkan API yang benar, lalu klik Enable.

Menyiapkan dari Dialogflow CX

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Buka tab Kelola di menu navigasi.
  5. Pilih Integrations.
  6. Klik Connect di Google Chat.
  7. Lengkapi informasi yang diperlukan berikut:
    • Nama: Nama yang ditampilkan kepada pengguna yang berinteraksi dengan atau menggunakan konten yang dibuat oleh aplikasi ini, seperti dalam pesan, penelusuran, dan @sebutan. Contoh, Dialogflow CX App.
    • URL Avatar: Gambar avatar yang ditampilkan kepada pengguna yang berinteraksi dengan aplikasi. Tentukan URL HTTPS yang menghosting gambar PNG persegi (rasio aspek 1:1). Ukuran minimum yang direkomendasikan: 256 x 256 piksel. Contoh, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • Description: Deskripsi aplikasi. Misalnya, A helpful bot that responds to real human conversation.
    • Lingkungan: Lingkungan yang akan dihubungkan. Pilih Environment sebagaimana mestinya.
  8. Masukkan alamat email untuk menyediakan aplikasi Chat ini bagi orang dan grup tertentu, sebagaimana berlaku.
  9. Klik Mulai.

Pengujian

Untuk menguji aplikasi yang telah dikonfigurasi, sebutkan aplikasi tersebut di ruang Google Chat atau kirim pesan langsung.

Contoh:

  1. Buka Google Chat.
  2. Klik Chat baru.
  3. Di kolom Tambahkan 1 orang atau lebih, masukkan nama aplikasi Chat Anda.
  4. Pilih aplikasi Chat Anda dari hasil. Pesan langsung akan terbuka.

Pesan respons lengkap

Anda dapat mendukung pesan respons kaya menggunakan Custom Payload di Fulfillment. Lihat API pesan Google Chat untuk mengetahui informasi tentang format pesan.

Pesan teks

Payload kustom berikut menyediakan pesan teks Google Chat:

{
  "text": "Hello, world"
}

Jika Anda menggunakan add-on Chat, payload kustom berikut menyediakan pesan teks Google Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "Your pizza delivery is here!"
        }
      }
    }
  }
}

Pesan kartu

Payload kustom berikut menyediakan pesan kartu Google Chat:

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow CX",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Payload kustom berikut menyediakan pesan kartu Google Chat jika Anda menggunakan add-on Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "subtitle": "Sent from Conversational Agents (Dialogflow CX)",
                  "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
                  "imageType": "CIRCLE"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "buttonList": {
                          "buttons": [
                            {
                              "text": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Respons khusus saluran

Jika dikonfigurasi, respons khusus saluran dengan saluran DF_CX_GOOGLE_CHAT akan otomatis digunakan saat agen merespons pesan Google Chat.