Integrasi Google Chat Agen Percakapan (Dialogflow CX) memungkinkan Anda membuat aplikasi Google Chat dengan pemahaman bahasa alami berdasarkan teknologi Agen Percakapan (Dialogflow CX).
Batasan
- Hanya input teks dalam bahasa default agen yang didukung oleh integrasi ini.
Menyiapkan Google Chat
Untuk menyiapkan integrasi Google Chat bagi agen, Anda memerlukan hal berikut:
- Akun Google Workspace dengan akses ke Google Chat.
- Project Google Cloud.
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.
Di konsol Google Cloud, aktifkan Google Chat API dan Dialogflow API.
Pastikan Anda mengaktifkan API di project Cloud yang benar, lalu klik Berikutnya.
Pastikan Anda mengaktifkan API yang benar, lalu klik Enable.
Menyiapkan dari Agen Percakapan (Dialogflow CX)
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Integrations di menu sidebar kiri.
- Klik Hubungkan di Google Chat.
- Isi 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. Contohnya,
Conversational Agents (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: 256x256 piksel. Contohnya,
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
. - Deskripsi: Deskripsi aplikasi. Misalnya,
A helpful bot that responds to real human conversation
.
- Nama: Nama yang ditampilkan kepada pengguna yang berinteraksi dengan atau menggunakan konten yang dibuat oleh aplikasi ini, seperti dalam pesan, penelusuran, dan @sebutan. Contohnya,
- Pilih Environment sebagaimana berlaku.
- Masukkan alamat email untuk membuat aplikasi Chat ini tersedia bagi orang dan grup tertentu sebagaimana berlaku.
- Klik Mulai.
Pengujian
Untuk menguji aplikasi yang dikonfigurasi, sebutkan aplikasi tersebut di ruang Google Chat atau kirim DM. Misalnya,
- Buka Google Chat.
- Klik Chat baru.
- Di kolom Tambahkan 1 orang atau lebih, ketik nama aplikasi Chat Anda.
- Pilih aplikasi Chat Anda dari hasil. Pesan langsung akan terbuka.
Pesan respons lengkap
Pesan respons yang kaya didukung menggunakan Payload Kustom di Fulfillment. Lihat API pesan Google Chat untuk mengetahui format pesan.
Pesan teks
Payload kustom berikut memberikan pesan teks Google Chat:
{ "text": "Hello, world" }
Pesan kartu
Payload kustom berikut memberikan pesan kartu Google Chat:
{ 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A card message!', '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': 'Read the docs!', 'onClick': { 'openLink': { 'url': 'https://developers.google.com/workspace/chat' } } } ] } } ] } ] } }] }
Respons khusus channel
Jika dikonfigurasi, respons khusus saluran dengan saluran DF_CX_GOOGLE_CHAT
akan otomatis digunakan saat agen merespons pesan Google Chat.