Kullanıcılar Google Chat'te bağlantı paylaştığında bağlamın değiştirilmesini önlemek için Chat uygulamanız, mesajlarına kart ekleyerek bağlantıyı önizleyebilir. Bu sayede kullanıcılar, daha fazla bilgi edinebilir ve doğrudan Google Chat'ten işlem yapabilir.
Örneğin, şirketin tüm müşteri hizmetleri temsilcilerini içeren bir Google Chat alanı ile Case-y adlı bir Chat uygulamasını düşünün. Temsilciler, Chat alanında sıklıkla müşteri hizmetleri destek kayıtlarının bağlantılarını paylaşır. İş arkadaşları, yaptıkları her işlemde atanan kişi, 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 durumunu değiştirmek isteyen bir kişi de bağlantıyı açmalıdır.
Bağlantı önizleme özelliği, alanda yerleşik Chat uygulaması olan Case-y'nin, destek kaydı bağlantısı paylaşıldığında atanan kişi, durum ve konuyu gösteren bir kart eklemesine olanak tanır. Karttaki düğmeler, temsilcilerin destek kaydının sahipliğini almasına ve durumu doğrudan sohbet akışından değiştirmesine olanak tanır.
Bağlantı önizlemenin işleyiş şekli
Bir kullanıcı mesajına bağlantı eklediğinde Chat uygulamasının bağlantıyı önizleyebileceğini bildiren bir çip gösterilir.
Mesaj gönderildikten sonra bağlantı, Chat uygulamasına gönderilir. Ardından, kart oluşturulur ve kullanıcının mesajına eklenir.
Bağlantının yanındaki kart, düğmeler gibi etkileşimli öğeler dahil olmak üzere bağlantı hakkında ek bilgiler sağlar. Chat uygulamanız, düğme tıklamaları gibi kullanıcı etkileşimlerine yanıt olarak ekteki kartı güncelleyebilir.
Mesajları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, Önizlemeyi kaldır'ı tıklayarak ekli kartı istedikleri zaman kaldırabilir.Bağlantı önizlemelerini yapılandırma
example.com
, support.example.com
ve support.example.com/cases/
gibi belirli bağlantıları Google Cloud Console'da Chat uygulamanızın yapılandırma sayfasında URL kalıpları olarak kaydedin. Böylece Chat uygulamanız bu bağlantıları önizleyebilir.
- Google Cloud Console'u açın.
- "Google Cloud"un yanındaki Aşağı oku tıklayın ve Chat uygulamanızın projesini açın.
- Arama alanına
Google Chat API
yazın ve Google Chat API'yi tıklayın. - Yönet > Yapılandırma'yı 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ını girin. Chat uygulaması, bu alanın bağlantılarını önizleyecek.
subdomain.example.com
gibi belirli bir alt alan adı için Chat uygulaması önizleme bağlantılarını almak istiyorsanız alt alan adını ekleyin.Alanın tamamına yönelik Chat uygulaması önizleme bağlantıları oluşturmak için alt alan adı olarak yıldız işareti (*) içeren bir joker karakter belirtin. Örneğin,
*.example.com
;subdomain.example.com
veany.number.of.subdomains.example.com
ile eşleşir.Yol öneki 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'ni boş bırakın.
Örneğin, Ana makine kalıbı
support.example.com
isesupport.example.com/cases/
öğesinde barındırılan vakaların URL'lerini eşleştirmek içincases/
girin.Done'ı (Bitti) tıklayın.
Kaydet'i tıklayın.
Artık kullanıcılar Chat uygulamanızı içeren bir Chat alanındaki mesaja, bağlantı önizleme URL kalıbıyla eşleşen bir bağlantı eklediklerinde, uygulamanız bağlantıyı önizler.
Bağlantıyı önizleme
Belirli bir bağlantı için bağlantı önizlemeyi yapılandırdıktan sonra, Chat uygulamanız daha fazla bilgi ekleyerek bağlantıyı tanıyabilir ve önizleyebilir.
Chat uygulamanızı içeren Chat alanlarında, bir kullanıcının mesajı bağlantı önizleme URL'si kalıbıyla eşleşen bir bağlantı içerdiğinde Chat uygulamanız bir MESSAGE
etkileşim etkinliği alır. Etkileşim etkinliğinin JSON 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
}
Chat uygulamanız, MESSAGE
etkinlik yükünde matchedUrl
alanının olup olmadığını kontrol ederek önizlenen bağlantıyla mesaja bilgi ekleyebilir. Chat uygulamanız basit bir kısa mesajla yanıt verebilir veya kart ekleyebilir.
Kısa mesajla yanıtla
Basit yanıtlar için Chat uygulamanız, basit bir kısa mesajla yanıt vererek ilgili bağlantıyı önizleyebilir. Bu örnekte, bağlantı önizleme URL'si kalıbıyla eşleşen bağlantı URL'sini tekrarlayan bir mesaj iliştirilmektedir.
Node.js
Apps Komut Dosyası
Kart ekle
Önizlenen bir bağlantıya kart eklemek için UPDATE_USER_MESSAGE_CARDS
türünde bir ActionResponse
döndürün. Bu örnekte basit bir kart ektedir.
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON hatası döndürerek bir kart mesajı gönderilmektedir. Apps Komut Dosyası kart hizmetini de kullanabilirsiniz.
Kart güncelleme
Önizlenen bağlantıya ekli kartı güncellemek için UPDATE_USER_MESSAGE_CARDS
türünde bir ActionResponse
döndürün. Chat uygulamaları yalnızca bir Chat uygulaması etkileşim etkinliğine yanıt olarak bağlantıları önizleyen kartları güncelleyebilir.
Chat uygulamaları, Chat API'yi eşzamansız olarak çağırarak bu kartları güncelleyemez.
Bağlantı önizleme, UPDATE_MESSAGE
türünde bir ActionResponse
döndürülmesini desteklemez. UPDATE_MESSAGE
yalnızca kart yerine mesajın tamamını güncellediğinden, güncelleme yalnızca Chat uygulaması orijinal mesajı oluşturduysa çalışır. Bağlantı önizleme, kullanıcı tarafından oluşturulan mesaja bir kart ekler. Bu nedenle, Chat uygulamasının bu mesajı güncelleme izni olmaz.
Bir işlevin Chat akışında hem kullanıcı tarafından hem de uygulama tarafından oluşturulan kartları güncellediğinden emin olmak için ActionResponse
özelliğini Chat uygulamasının mı yoksa bir kullanıcının mı oluşturduğuna bağlı olarak dinamik olarak ayarlayın.
- İletiyi 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: Ekteki kartın onclick
özelliğinin bir parçası olarak özel bir actionMethodName
belirleyip kontrol etme (iletiyi kullanıcı tarafından oluşturulmuş olarak tanımlar) veya iletinin bir kullanıcı tarafından oluşturulup oluşturulmadığını kontrol etme.
1. Seçenek: actionMethodName
olup olmadığını kontrol edin
Önizlenen kartlarda CARD_CLICKED
etkileşim etkinliklerini düzgün şekilde işlemek üzere actionMethodName
kullanmak için ekli kartın onclick
özelliğinin bir parçası 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"
tarafından düğme bir bağlantı önizlemesinin parçası olarak tanımlandığında, eşleşen bir actionMethodName
olup olmadığını kontrol ederek doğru ActionResponse
değerinin dinamik olarak döndürülmesi mümkündür:
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON hatası döndürerek bir kart mesajı gönderilmektedir. Apps Komut Dosyası kart hizmetini de kullanabilirsiniz.
2. Seçenek: Gönderen türünü kontrol etme
message.sender.type
değerinin HUMAN
veya BOT
olup olmadığını kontrol edin. HUMAN
değeri geçerliyse ActionResponse
değerini UPDATE_USER_MESSAGE_CARDS
olarak ayarlayın; ActionResponse
değerini ise UPDATE_MESSAGE
olarak ayarlayın. Bunun için uygulamanız gereken adımlar:
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON hatası döndürerek bir kart mesajı gönderilmektedir. Apps Komut Dosyası kart hizmetini de kullanabilirsiniz.
Kart güncellemenin tipik bir nedeni, düğmenin tıklanmasıdır. Bir önceki Kart ekle bölümünde yer alan Bana Ata düğmesine geri dönün. Aşağıdaki eksiksiz örnekte kart, bir kullanıcı Bana Ata'yı tıkladıktan sonra "Siz"e atandığını gösterecek şekilde güncellenir. Bu örnekte, gönderen türü kontrol edilerek ActionResponse
dinamik bir şekilde ayarlanır.
Tam örnek: Müşteri hizmetleri Chat uygulaması için destek kaydı oluşturun
Müşteri hizmetleri temsilcilerinin ortak çalıştığı bir Chat alanında paylaşılan destek kayıtlarının bağlantılarını önizleyen Chat uygulaması Case-y için kodun tamamını aşağıda bulabilirsiniz.
Node.js
Apps Komut Dosyası
Bu örnekte, kart JSON hatası döndürerek bir kart mesajı gönderilmektedir. Apps Komut Dosyası kart hizmetini de kullanabilirsiniz.
Sınırlar 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.
- Chat uygulamalarında her mesaj için bir bağlantı önizlenebilir. Tek bir iletide birden fazla önizlenebilir bağlantı varsa yalnızca ilk önizlenebilir bağlantı önizlenebilir.
- Sohbet uygulamaları yalnızca
https://
ile başlayan bağlantıları önizler. Bu nedenlehttps://support.example.com/cases/
önizlemesinesupport.example.com/cases/
ile başlamaz. - Mesaj, Chat uygulamasına gönderilen eğik çizgi komutu gibi başka bilgiler içermediği sürece, 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
ları destekler ve yalnızca Chat uygulaması etkileşim etkinliğine yanıt verir. Bağlantı önizlemeleri, önizlenen bir bağlantıya Chat API üzerinden eklenmiş kartların güncellenmesi içinUPDATE_MESSAGE
veya eşzamansız istekleri 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ızdaki hataları ayıklamanız gerekebilir. Günlükleri okumak için Google Cloud Console'da Günlük Gezgini'ni ziyaret edin.