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 orang-orang melakukan tindakan langsung dari Google Chat.
Misalnya, bayangkan ruang Google Chat yang menyertakan semua agen layanan pelanggan perusahaan dan aplikasi Chat bernama Case-y. Agen sering membagikan link ke kasus layanan pelanggan di ruang Chat, dan setiap kali mereka melakukannya, kolega 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 perlu membuka link tersebut.
Pratinjau link memungkinkan aplikasi Chat penduduk, Case-y, untuk melampirkan kartu yang menunjukkan penerima, status, dan subjek setiap kali seseorang membagikan link kasus. Tombol di kartu memungkinkan agen untuk mengambil alih kasus dan mengubah status langsung dari streaming chat.
Cara kerja pratinjau link
Saat seseorang menambahkan link ke pesannya, akan muncul chip yang memberi tahu bahwa aplikasi Chat mungkin akan melihat pratinjau link tersebut.
Setelah mengirim pesan, link akan dikirim ke aplikasi Chat, yang kemudian akan membuat dan melampirkan kartu ke pesan pengguna.
Bersamaan dengan link, kartu memberikan informasi tambahan tentang link, termasuk elemen interaktif seperti tombol. Aplikasi Chat Anda dapat memperbarui 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, orang tersebut dapat mencegah pratinjau dengan mengklik
pada 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 ada, klik Panah bawah .
Di kolom Pola host, 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
, menyertakan subdomain.Agar pratinjau aplikasi Chat ditautkan 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 untuk ditambahkan ke domain pola host.
Untuk mencocokkan semua URL di domain pola host, biarkan Awalan jalur kosong.
Misalnya, jika Pola host adalah
support.example.com
, untuk mencocokkan 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 ke pesan di ruang Chat yang menyertakan aplikasi Chat Anda, aplikasi akan melihat pratinjau link tersebut.
Melihat pratinjau link
Setelah Anda mengonfigurasi pratinjau link untuk link tertentu, aplikasi Chat Anda dapat mengenali dan melihat pratinjau link dengan melampirkan informasi selengkapnya.
Di dalam ruang Chat yang menyertakan aplikasi Chat Anda, jika pesan seseorang berisi link yang cocok dengan pola URL pratinjau link, link tersebut akan dikirim ke aplikasi Chat Anda sebagai atribut matchedUrl
di objek message
:
JSON
message {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
Dengan memeriksa keberadaan atribut matchedUrl
pada objek 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.
Balas dengan SMS
Untuk respons sederhana, aplikasi Chat Anda dapat melihat pratinjau link dengan membalas pesan teks sederhana ke sebuah 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
jenis UPDATE_USER_MESSAGE_CARDS
. Contoh ini melampirkan kartu sederhana.
Node.js
Apps Script
Memperbarui kartu
Untuk memperbarui kartu yang dilampirkan ke link yang dipratinjau, tampilkan ActionResponse
jenis UPDATE_USER_MESSAGE_CARDS
. Kartu yang dilampirkan ke link yang dipratinjau hanya diperbarui sebagai respons terhadap permintaan sinkron dari Peristiwa chat. Permintaan asinkron untuk memperbarui kartu yang dilampirkan ke link yang dipratinjau melalui Chat REST API tidak didukung.
Pratinjau link tidak mendukung ditampilkannya ActionResponse
dari jenis UPDATE_MESSAGE
. Karena UPDATE_MESSAGE
akan memperbarui seluruh pesan, bukan hanya kartu, pesan tersebut 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 yang dibuat pengguna dan dibuat aplikasi di streaming Chat, tetapkan ActionResponse
secara dinamis berdasarkan apakah aplikasi Chat atau pengguna membuat pesan.
- Jika pengguna membuat pesan, tetapkan
ActionResponse
keUPDATE_USER_MESSAGE_CARDS
. - Jika aplikasi Chat membuat pesan, tetapkan
ActionResponse
keUPDATE_MESSAGE
.
Ada dua cara untuk melakukannya: menentukan dan memeriksa actionMethodName
kustom sebagai bagian dari properti onclick
kartu yang dilampirkan (yang mengidentifikasi pesan sebagai buatan pengguna) atau memeriksa untuk melihat apakah pesan dibuat oleh pengguna.
Opsi 1: Periksa actionMethodName
Agar dapat menggunakan actionMethodName
untuk menangani peristiwa klik kartu dengan benar pada kartu yang dipratinjau, tetapkan actionMethodName
kustom sebagai bagian dari properti onclick
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"
yang mengidentifikasi tombol sebagai bagian dari pratinjau link, Anda dapat secara dinamis menampilkan ActionResponse
yang benar dengan memeriksa actionMethodName
yang cocok:
Node.js
Apps Script
Opsi 2: Periksa jenis pengirim
Periksa untuk melihat 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 respons terhadap klik tombol. Ingat kembali tombol Tetapkan ke Saya dari bagian sebelumnya, Lampirkan kartu. Contoh lengkap berikut akan memperbarui kartu agar dapat ditetapkan ke "Anda" setelah pengguna mengklik Tetapkan ke Saya. Contoh ini secara dinamis menetapkan ActionResponse
dengan memeriksa jenis pengirim.
Contoh lengkap: Membuat kasus untuk aplikasi Chat layanan pelanggan
Berikut adalah kode lengkap untuk Case-y, aplikasi Chat yang menampilkan pratinjau link ke kasus yang dibagikan di ruang Chat tempat agen layanan pelanggan berkolaborasi.
Node.js
Apps Script
Batas dan pertimbangan
Saat Anda mengonfigurasi pratinjau link untuk aplikasi Chat, perhatikan batasan dan pertimbangan berikut:
- Setiap aplikasi Chat mendukung pratinjau link hingga 5 pola URL.
- Aplikasi Chat mempratinjau satu link per pesan. Jika beberapa link yang dapat dipratinjau muncul dalam satu pesan, hanya pratinjau link pertama yang dapat dipratinjau.
- Aplikasi Chat hanya melihat pratinjau link yang dimulai dengan
https://
, jadihttps://support.example.com/cases/
pratinjau tidak, tetapisupport.example.com/cases/
tidak. - Kecuali jika pesan menyertakan informasi lain yang dikirimkan 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 permintaan sinkron dari peristiwa Chat. Pratinjau link tidak mendukungUPDATE_MESSAGE
atau permintaan asinkron untuk memperbarui kartu yang dilampirkan ke link yang dipratinjau melalui Chat REST API. Untuk mempelajari lebih lanjut, lihat Memperbarui kartu.
Men-debug pratinjau link
Saat menerapkan pratinjau link, Anda mungkin perlu men-debug aplikasi Chat dengan membaca log aplikasi. Untuk membaca log, buka Logs Explorer di Google Cloud Console.