Untuk mencegah pengalihan konteks saat pengguna membagikan link di Google Chat, aplikasi Chat Anda dapat melihat pratinjau link dengan melampirkan kartu ke pesan mereka yang memberikan lebih banyak informasi dan memungkinkan pengguna mengambil tindakan langsung dari Google Chat.
Misalnya, bayangkan sebuah ruang Google Chat yang menyertakan semua agen layanan pelanggan perusahaan ditambah aplikasi Chat bernama Case-y. Agen sering kali membagikan link ke kasus layanan pelanggan di ruang Chat. Setiap kali mereka melakukannya, rekan mereka harus membuka link kasus untuk melihat detail seperti penerima tugas, status, dan subjek. Demikian pula, jika seseorang ingin mengambil alih kasus atau mengubah status, ia harus membuka link tersebut.
Pratinjau link memungkinkan aplikasi Chat penghuni ruang, Case-y, untuk melampirkan kartu yang menunjukkan penerima tugas, status, dan subjek setiap kali seseorang membagikan link kasus. Tombol di kartu memungkinkan agen mengambil alih kasus dan mengubah status langsung dari streaming chat.
Cara kerja pratinjau link
Saat seseorang menambahkan link ke pesannya, chip akan muncul yang memberi tahu bahwa aplikasi Chat mungkin melihat pratinjau link tersebut.
Setelah mengirim pesan, link akan dikirim ke aplikasi Chat, yang kemudian membuat dan melampirkan kartu ke pesan pengguna.
Di samping link, kartu tersebut memberikan informasi tambahan tentang link tersebut, termasuk elemen interaktif seperti tombol. Aplikasi Chat Anda dapat mengupdate kartu yang dilampirkan sebagai respons terhadap interaksi pengguna, seperti klik tombol.
Jika seseorang tidak ingin aplikasi Chat melihat pratinjau link-nya dengan melampirkan kartu ke pesan, dia dapat mencegah pratinjau dengan mengklik
di chip pratinjau. Pengguna dapat menghapus kartu yang dilampirkan kapan saja dengan mengklik Hapus pratinjau.Mengonfigurasi pratinjau link
Daftarkan link tertentu - seperti example.com
, support.example.com
, dan support.example.com/cases/
- sebagai pola URL di halaman konfigurasi aplikasi Chat Anda di konsol Google Cloud sehingga aplikasi Chat Anda dapat melihat pratinjaunya.
- Buka konsol Google Cloud.
- Di samping "Google Cloud", klik Panah bawah , lalu buka project aplikasi Chat Anda.
- Di kolom penelusuran, ketik
Google Chat API
, lalu klik Google Chat API. - Klik Kelola > Konfigurasi.
- Di bagian Pratinjau link, tambahkan atau edit pola URL.
- Guna mengonfigurasi pratinjau link untuk pola URL baru, klik Tambahkan Pola URL.
- Untuk mengedit konfigurasi pola URL yang sudah ada, klik Panah bawah .
Di kolom Host pattern, masukkan domain pola URL. Aplikasi Chat akan melihat pratinjau link ke domain ini.
Agar link pratinjau aplikasi Chat untuk subdomain tertentu, seperti
subdomain.example.com
, sertakan subdomain.Agar aplikasi Chat menampilkan link pratinjau untuk seluruh domain, tentukan karakter pengganti dengan tanda bintang (*) sebagai subdomain. Misalnya,
*.example.com
cocok dengansubdomain.example.com
danany.number.of.subdomains.example.com
.Di kolom Awalan jalur, masukkan jalur yang akan ditambahkan ke domain pola host.
Untuk mencocokkan semua URL di domain pola host, kosongkan Awalan jalur.
Misalnya, jika Pola host adalah
support.example.com
, agar cocok dengan URL untuk kasus yang dihosting disupport.example.com/cases/
, masukkancases/
.Klik Done.
Klik Simpan.
Sekarang, setiap kali seseorang menyertakan link yang cocok dengan pola URL pratinjau link dengan pesan di ruang Chat yang berisi aplikasi Chat Anda, aplikasi Anda akan mempratinjau link tersebut.
Melihat pratinjau link
Setelah Anda mengonfigurasi pratinjau link untuk link tertentu, aplikasi Chat dapat mengenali dan melihat pratinjau link dengan melampirkan lebih banyak informasi ke link tersebut.
Di dalam ruang Chat yang menyertakan
aplikasi Chat Anda, saat pesan seseorang berisi link yang
cocok dengan pola URL pratinjau link, aplikasi Chat Anda
akan menerima
peristiwa interaksi MESSAGE
. Payload JSON untuk peristiwa interaksi berisi kolom matchedUrl
:
JSON
message {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
Dengan memeriksa keberadaan kolom matchedUrl
di payload peristiwa MESSAGE
, aplikasi Chat Anda dapat menambahkan informasi ke pesan dengan link yang dipratinjau. Aplikasi Chat Anda dapat
membalas dengan pesan teks sederhana atau melampirkan kartu.
Membalas dengan SMS
Untuk respons sederhana, aplikasi Chat Anda dapat melihat pratinjau link dengan membalas pesan teks sederhana ke link. Contoh ini melampirkan pesan yang mengulangi URL link yang cocok dengan pola URL pratinjau link.
Node.js
Apps Script
Lampirkan kartu
Untuk melampirkan kartu ke link yang dipratinjau, tampilkan ActionResponse
dengan jenis UPDATE_USER_MESSAGE_CARDS
. Contoh ini melampirkan kartu sederhana.
Node.js
Apps Script
Memperbarui kartu
Untuk mengupdate kartu yang dilampirkan ke link yang dipratinjau, tampilkan
ActionResponse
jenis UPDATE_USER_MESSAGE_CARDS
. Aplikasi Chat hanya dapat memperbarui
kartu yang melihat pratinjau link sebagai respons terhadap
peristiwa interaksi aplikasi Chat.
Aplikasi Chat tidak dapat memperbarui kartu ini dengan memanggil Chat API
secara asinkron.
Pratinjau link tidak mendukung ditampilkannya ActionResponse
jenis UPDATE_MESSAGE
. Karena UPDATE_MESSAGE
memperbarui seluruh pesan, bukan hanya kartu, fitur ini hanya berfungsi jika aplikasi Chat membuat pesan asli. Pratinjau link akan melampirkan kartu ke pesan yang dibuat pengguna, sehingga aplikasi Chat tidak memiliki izin untuk memperbaruinya.
Untuk memastikan fungsi memperbarui kartu buatan pengguna dan buatan aplikasi di aliran data Chat, tetapkan ActionResponse
secara dinamis berdasarkan apakah aplikasi Chat atau pengguna yang membuat pesan tersebut.
- Jika pengguna yang membuat pesan, setel
ActionResponse
keUPDATE_USER_MESSAGE_CARDS
. - Jika aplikasi Chat membuat pesan, setel
ActionResponse
keUPDATE_MESSAGE
.
Ada dua cara untuk melakukannya: menentukan dan memeriksa actionMethodName
kustom sebagai bagian dari properti onclick
pada kartu yang dilampirkan (yang mengidentifikasi pesan sebagai buatan pengguna) atau memeriksa apakah pesan dibuat oleh pengguna.
Opsi 1: Periksa actionMethodName
Untuk menggunakan actionMethodName
guna menangani peristiwa interaksi CARD_CLICKED
dengan benar pada kartu yang dipratinjau, setel actionMethodName
kustom sebagai bagian dari properti onclick
pada kartu yang dilampirkan:
JSON
. . . // Preview card details
{
"textButton": {
"text": "ASSIGN TO ME",
"onClick": {
// actionMethodName identifies the button to help determine the
// appropriate ActionResponse.
"action": {
"actionMethodName": "assign",
}
}
}
}
. . . // Preview card details
Dengan "actionMethodName": "assign"
mengidentifikasi tombol sebagai bagian dari pratinjau link, Anda dapat menampilkan ActionResponse
yang benar secara dinamis dengan memeriksa actionMethodName
yang cocok:
Node.js
Apps Script
Opsi 2: Memeriksa jenis pengirim
Periksa apakah message.sender.type
adalah HUMAN
atau BOT
. Jika HUMAN
, tetapkan ActionResponse
ke UPDATE_USER_MESSAGE_CARDS
, jika tidak tetapkan ActionResponse
ke UPDATE_MESSAGE
. Berikut caranya:
Node.js
Apps Script
Alasan umum untuk memperbarui kartu adalah sebagai respons terhadap klik tombol. Ingat kembali tombol Tugaskan kepada Saya dari bagian sebelumnya, Lampirkan kartu. Contoh lengkap berikut ini memperbarui kartu, sehingga kartu tersebut ditetapkan ke "Anda" setelah pengguna mengklik Tetapkan kepada Saya. Contoh ini secara dinamis menetapkan ActionResponse
dengan memeriksa jenis pengirim.
Contoh lengkap: Case-y aplikasi Chat layanan pelanggan
Berikut ini kode lengkap untuk Case-y, aplikasi Chat yang mempratinjau link ke kasus yang dibagikan di ruang Chat tempat agen layanan pelanggan berkolaborasi.
Node.js
Apps Script
Batasan dan pertimbangan
Saat mengonfigurasi pratinjau link untuk aplikasi Chat, perhatikan batasan dan pertimbangan berikut:
- Setiap aplikasi Chat mendukung pratinjau link untuk hingga 5 pola URL.
- Aplikasi chat melihat pratinjau satu link per pesan. Jika ada beberapa link yang dapat dipratinjau dalam satu pesan, hanya pratinjau link pertama yang dapat dipratinjau.
- Aplikasi chat hanya mempratinjau link yang dimulai dengan
https://
, jadi pratinjauhttps://support.example.com/cases/
, sedangkansupport.example.com/cases/
tidak. - Kecuali jika pesan menyertakan informasi lain yang dikirim ke aplikasi Chat, seperti perintah garis miring, hanya URL link yang akan dikirim ke aplikasi Chat melalui pratinjau link.
- Kartu yang dilampirkan ke link yang dipratinjau hanya mendukung
ActionResponse
jenisUPDATE_USER_MESSAGE_CARDS
, dan hanya sebagai respons terhadap peristiwa interaksi aplikasi Chat. Pratinjau link tidak mendukung permintaanUPDATE_MESSAGE
atau asinkron untuk mengupdate kartu yang dilampirkan ke link yang dipratinjau melalui Chat API. Untuk mempelajari lebih lanjut, lihat Memperbarui kartu.
Men-debug pratinjau link
Saat mengimplementasikan pratinjau link, Anda mungkin perlu men-debug aplikasi Chat dengan membaca log aplikasi. Untuk membaca log, buka Logs Explorer di konsol Google Cloud.