Kullanıcılar Google Chat'te bir bağlantı paylaştığında bağlam değişikliğini önlemek için Chat uygulamanız, mesajlarına daha fazla bilgi veren ve kullanıcıların doğrudan Google Chat'ten işlem yapmasına olanak tanıyan bir kart ekleyerek bağlantıyı önizleyebilir.
Örneğin, bir şirketin müşteri hizmetleri temsilcilerinin tamamını içeren bir Google Chat alanı ve Case-y adlı bir Chat uygulaması düşünün. Temsilciler Chat alanında müşteri hizmetleri destek kayıtlarının bağlantılarını sık sık paylaşırlar. Temsilciler, oluşturdukları her seferde atanan, durum ve konu gibi ayrıntıları görmek için destek kaydı bağlantısını açmalıdır. Benzer şekilde, bir destek kaydının sahipliğini almak veya durumu değiştirmek isteyen bir kullanıcının bağlantıyı açması gerekir.
Bağlantı önizleme, alanın yerleşik Chat uygulamasında (Case-y) bir destek kaydı bağlantısı paylaşıldığında atanan kişiyi, durumu ve konuyu gösteren bir kart ekleyebilmesini sağlar. Karttaki düğmeler, temsilcilerin destek kaydının sahipliğini almasını ve durumu doğrudan sohbet akışından değiştirmesini sağlar.
Bağlantı önizlemenin işleyiş şekli
Bir kullanıcı, mesajına bağlantı eklediğinde, ilgili kullanıcının bu bağlantıyı bir Chat uygulamasında önizleyebileceğini belirten bir çip gösterilir.
Mesaj gönderildikten sonra bağlantı Chat uygulamasına gönderilir. Uygulama, kartı oluşturup kullanıcının mesajına ekler.
Kart, bağlantının yanında düğmeler gibi etkileşimli öğeler dahil olmak üzere bağlantı hakkında ek bilgiler sağlar. Chat uygulamanız, ekteki kartı düğme tıklamaları gibi kullanıcı etkileşimlerine yanıt olarak güncelleyebilir.
Mesajına kart ekleyerek Chat uygulamasının bağlantısını önizlemesini istemeyen kullanıcılar, önizleme çipindeki
simgesini tıklayarak önizlemeyi engelleyebilir. Kullanıcılar, ekli kartı Önizlemeyi kaldır'ı tıklayarak istedikleri zaman kaldırabilir.Ön koşullar
Node.js
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Bir HTTP hizmeti kullanarak etkileşimli Chat uygulaması için bu hızlı başlangıç kılavuzunu tamamlayın.
Apps Komut Dosyası
Etkileşimli özellikler için etkinleştirilmiş bir Google Chat uygulaması. Bir Apps Komut Dosyası'ndaki etkileşimli Chat uygulaması için bu hızlı başlangıç kılavuzunu tamamlayın.
Bağlantı önizlemelerini yapılandırma
example.com
, support.example.com
ve support.example.com/cases/
gibi belirli bağlantıları, Chat uygulamanızın önizleyebilmesi için Google Cloud Console'daki Chat uygulamanızın yapılandırma sayfasında URL kalıpları olarak kaydedin.
- Google Cloud Console'u açın.
- "Google Cloud"un yanında Aşağı oku tıklayın ve Chat uygulamanızın projesini açın.
- Arama alanına
Google Chat API
yazıp Google Chat API'yi tıklayın. - > Yapılandırmayı Yönet'i tıklayın.
- Bağlantı önizlemeleri altında, bir URL kalıbı ekleyin veya düzenleyin.
- Yeni bir URL kalıbı için bağlantı önizlemelerini yapılandırmak üzere URL Kalıbı Ekle'yi tıklayın.
- Mevcut bir URL kalıbının yapılandırmasını düzenlemek için aşağı oku tıklayın.
Ana makine kalıbı alanına URL kalıbının alan adını girin. Chat uygulaması, bu alanın bağlantılarını önizleyecek.
subdomain.example.com
gibi belirli bir alt alan adına ait Chat uygulaması önizleme bağlantılarının alt alan adını dahil edin.Alanın tamamı için Chat uygulaması önizleme bağlantıları oluşturmak istiyorsanız alt alan adı olarak yıldız işareti (*) içeren bir joker karakter belirleyin. Örneğin,
*.example.com
,subdomain.example.com
veany.number.of.subdomains.example.com
ile eşleşir.Yol ön eki alanına, ana makine kalıbı alanına eklenecek bir yol girin.
Ana makine kalıbı alanındaki tüm URL'leri eşleştirmek için Yol öneki alanını boş bırakın.
Örneğin, ana makine kalıbı
support.example.com
isesupport.example.com/cases/
alanında barındırılan destek yazışmalarının URL'lerini eşleştirmek içincases/
değerini girin.Bitti'yi tıklayın.
Kaydet'i tıklayın.
Artık kullanıcılar Chat uygulamanızı içeren bir Chat alanındaki mesajlara bağlantı önizleme URL'si kalıbıyla eşleşen bir bağlantı eklediğinde uygulamanız bağlantıyı önizler.
Bağlantıları önizleme
Belirli bir bağlantı için bağlantı önizlemeyi yapılandırdıktan sonra, Chat uygulaması şu yöntemi kullanarak bağlantıyı tanıyıp önizleyebilir: daha fazla bilgi ekleyebilirsiniz.
Şunu içeren Chat alanlarında:
Chat uygulaması: Bir kullanıcının mesajında
bir bağlantı önizleme URL'si kalıbıyla eşleşirse, Chat uygulamanız
CANNOT TRANSLATE
MESSAGE
etkileşim etkinliği. JSON
etkileşim etkinliğinin yükü matchedUrl
alanını içerir:
JSON
"message": {
. . . // other message attributes redacted
"matchedUrl": {
"url": "https://support.example.com/cases/case123"
},
. . . // other message attributes redacted
}
MESSAGE
etkinliğinde matchedUrl
alanının olup olmadığını kontrol ederek
yardımcı olacaksa, Chat uygulamanız
mesajı görebilirsiniz. Chat uygulamanız şunları yapabilir:
basit bir kısa mesajla yanıt verebilir veya kart ekleyebilirsiniz.
Kısa mesajla yanıtla
Basit yanıtlar için Chat uygulamanız bir bağlantıyı önizleyebilir basit bir kısa mesajla yanıt vererek bir bağlantı ekler. Bu örnekte, Google Etiket Yöneticisi'nden gelen bir bağlantı önizleme URL'si kalıbıyla eşleşir.
Node.js
Apps Komut Dosyası
Kart ekleyin
Önizlenen bir bağlantıya kart eklemek için:
şunu döndür:
ActionResponse
UPDATE_USER_MESSAGE_CARDS
türünde. Bu örnekte basit bir kart ekli.
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON'a ekleyin. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
Kart güncelleme
Önizlenen bir bağlantıya ekli kartı güncellemek için
ActionResponse
UPDATE_USER_MESSAGE_CARDS
türünde. Chat uygulamaları yalnızca güncellenebilir.
bir yanıt olarak bağlantıları önizleyen
Chat uygulaması ile etkileşim etkinliği.
Chat uygulamaları, Chat API'yi çağırarak bu kartları güncelleyemez
eşzamansız olarak ayarlayabilirsiniz.
Bağlantı önizleme, UPDATE_MESSAGE
türünde ActionResponse
döndürmeyi desteklemez. UPDATE_MESSAGE
, yalnızca kartı değil, mesajın tamamını güncellediğinden bu işlem yalnızca orijinal mesajı Chat uygulaması tarafından oluşturulmuştur. Bağlantı önizleme, kullanıcı tarafından oluşturulan mesaja bir kart ekler. Bu nedenle, Chat uygulamasının bu mesajı güncelleme izni yoktur.
Bir işlevin Chat akışındaki hem kullanıcı tarafından hem de uygulama tarafından oluşturulan kartları güncellediğinden emin olmak için ActionResponse
öğesini, Chat uygulamasının mı yoksa bir kullanıcının mı oluşturduğuna bağlı olarak dinamik olarak ayarlayın.
- Mesajı bir kullanıcı oluşturduysa
ActionResponse
değeriniUPDATE_USER_MESSAGE_CARDS
olarak ayarlayın. - Mesajı bir Chat uygulaması oluşturduysa
ActionResponse
değeriniUPDATE_MESSAGE
olarak ayarlayın.
Bunu yapmanın iki yolu vardır: Ekli kartın onclick
özelliğinin bir parçası olarak özel bir actionMethodName
belirtmek ve kontrol etmek (iletiyi kullanıcı tarafından oluşturulmuş olarak tanımlar) veya iletinin bir kullanıcı tarafından oluşturulup oluşturulmadığını kontrol etmek.
1. seçenek: actionMethodName
'i kontrol edin
actionMethodName
özelliğini kullanarak önizlenen kartlarda CARD_CLICKED
etkileşim etkinliğini düzgün bir şekilde işlemek için ekli kartın onclick
mülkü olarak özel bir actionMethodName
ayarlayın:
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
"actionMethodName": "assign"
, düğmeyi bağlantı önizlemesinin parçası olarak tanımlarken, eşleşen bir actionMethodName
olup olmadığını kontrol ederek doğru ActionResponse
değerini dinamik olarak döndürmek mümkündür:
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON'a ekleyin. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
2. Seçenek: Gönderen türünü kontrol etme
message.sender.type
adlı değerin HUMAN
mü yoksa BOT
mi olduğunu kontrol edin. HUMAN
değeri için ActionResponse
değerini UPDATE_USER_MESSAGE_CARDS
olarak ayarlayın. Aksi takdirde ActionResponse
değerini UPDATE_MESSAGE
olarak ayarlayın. Bunun için uygulamanız gereken adımlar:
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON'a ekleyin. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
Kart güncellemenin tipik bir nedeni düğmenin tıklanmasıdır. Bir önceki bölüm olan Kart ekle bölümündeki Bana Ata düğmesini tekrar kullanın. Aşağıdaki tam örnekte, kart "Size" atandığı şekilde güncellenir kullanıcı Bana Ata'yı tıkladıktan sonra. Örnek, gönderen türünü kontrol ederek ActionResponse
öğesini dinamik olarak ayarlar.
Eksiksiz örnek: Case-y müşteri hizmetleri Chat uygulaması
Aşağıda, müşteri hizmetleri temsilcilerinin ortak çalıştığı bir Chat alanında paylaşılan destek kayıtlarının bağlantılarını önizleyen bir Chat uygulaması olan Case-y uygulamasının tam kodunu görebilirsiniz.
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON'a ekleyin. Ayrıca şunu da kullanabilirsiniz: Apps Komut Dosyası kart hizmeti.
Sınırlamalar ve dikkat edilmesi gereken noktalar
Chat uygulamanız için bağlantı önizlemelerini yapılandırırken aşağıdaki sınırları ve dikkat edilmesi gereken noktaları göz önünde bulundurun:
- Her Chat uygulaması en fazla 5 URL kalıbı için bağlantı önizlemelerini destekler.
- Sohbet uygulamaları, mesaj başına bir bağlantıyı önizler. Tek bir mesajda birden fazla önizlenebilir bağlantı varsa yalnızca ilk önizlenebilir bağlantı önizlenir.
- Sohbet uygulamaları yalnızca
https://
ile başlayan bağlantıları önizler. Dolayısıylahttps://support.example.com/cases/
önizleme yapar, ancaksupport.example.com/cases/
önizleme yapmaz. - Mesaj, eğik çizgi komutu gibi Chat uygulamasına gönderilen başka bilgileri içermiyorsa bağlantı önizlemeleri aracılığıyla Chat uygulamasına yalnızca bağlantı URL'si gönderilir.
- Önizlenen bağlantılara eklenen kartlar yalnızca
UPDATE_USER_MESSAGE_CARDS
türündekiActionResponse
türlerini ve sadece Chat uygulaması etkileşim etkinliklerine yanıt olarak destekler. Bağlantı önizlemeleri, Chat API üzerinden önizlenen bir bağlantıya eklenmiş kartların güncellenmesine yönelik eşzamansız istekleri veyaUPDATE_MESSAGE
isteklerini desteklemez. Daha fazla bilgi edinmek için Kart güncelleme başlıklı makaleyi inceleyin.
Bağlantı önizlemelerinde hata ayıklama
Bağlantı önizlemelerini uygularken, uygulamanın günlüklerini okuyarak Chat uygulamanızda hata ayıklamanız gerekebilir. Günlükleri okumak için Google Cloud Console'da Günlük Gezgini'ni ziyaret edin.