Sohbet kavramları

Makale
11/16/2023

Azure İletişim Hizmetleri Sohbet, platformlar arası uygulamalarınıza gerçek zamanlı metin iletişimi eklemenize yardımcı olabilir. Bu sayfada önemli Sohbet kavramları ve özellikleri özetlemektedir. SDK'lar , diller, platformlar ve ayrıntılı özellik desteği listeleri için İletişim Hizmetleri Sohbet Yazılım Geliştirme Seti'ne (SDK) Genel Bakış bölümüne bakın.

Sohbet API'leri, kalıcı olarak depolanan metin ve veri iletişimi için otomatik ölçeklendirme hizmeti sağlar. Diğer önemli özellikler şunlardır:

Özel Kimlik ve Adresleme - Azure İletişim Hizmetleri, iletişim uç noktalarını ele almak için genel kimlikler sağlar. İstemciler, Azure hizmetinde kimlik doğrulaması yapmak ve denetiminizde birbirleriyle iletişim kurmak için bu kimlikleri chat threads kullanır.
Şifreleme - Sohbet SDK'ları trafiği şifreler ve kablo üzerinde oynanmasını önler.
Microsoft Teams Toplantıları - Sohbet SDK'ları Teams toplantılarına katılabilir ve Teams sohbet iletileriyle iletişim kurabilir.
Gerçek Zamanlı Bildirimler - Sohbet SDK'ları , uzak bir kullanıcının yazarken olduğu gibi gerçek zamanlı bildirimler almak için verimli kalıcı bağlantı (WebSockets) kullanır. Uygulamalar arka planda çalışırken, son kullanıcılara yeni iş parçacıkları ve iletiler hakkında bilgi vermek için açılır bildirimleri ("bildirimler") tetiklemeye yönelik yerleşik işlevler kullanılabilir.
Bot Genişletilebilirliği - Azure Bot tümleştirmesi ile Sohbet hizmetine Azure botları eklemek kolaydır.

Sohbete genel bakış

Sohbet konuşmaları sohbet yazışmaları içinde gerçekleşir. Sohbet yazışmaları aşağıdaki özelliklere sahiptir:

Sohbet yazışması kimliği onundur ChatThreadId.
Sohbet yazışmaları, ileti gönderebilen katılımcılar olarak sıfır ile 250 arasında kullanıcıya sahiptir.
Kullanıcı sınırsız sayıda sohbet yazışmasının parçası olabilir.
Yalnızca yazışma katılımcıları ileti gönderebilir veya alabilir, katılımcı ekleyebilir veya katılımcıları kaldırabilir.
Kullanıcılar, oluşturdukları tüm sohbet yazışmalarına katılımcı olarak eklenir.

Kullanıcı erişimi

Azure İletişim Hizmetleri, sohbet belirteçlerini kullanarak üç kullanıcı erişim denetimi düzeyini destekler. Ayrıntılar için bkz . Kimlik ve Belirteçler . Katılımcıların diğer katılımcılar tarafından gönderilen iletilere yazma erişimi yoktur. Bu, yalnızca ileti gönderenin gönderilen iletileri güncelleştirebileceği veya silebileceği anlamına gelir. Başka bir katılımcı bunu yapmaya çalışırsa bir hata alır.

Sohbet Verileri

Azure İletişim Hizmetleri, sohbet iletilerini müşteri tarafından silinene kadar süresiz olarak depolar. Katılımcıların belirli bir yazışmanın ileti geçmişini görüntülemek için kullanabileceği ListMessages sohbet yazışması. Sohbet yazışmasından kaldırılan kullanıcılar önceki ileti geçmişini görüntüleyebilir ancak yeni ileti gönderemez veya alamaz. Yanlışlıkla silinen iletiler sistem tarafından kurtarılamaz. Azure İletişim Hizmetleri sohbet hizmetinde depolanan veriler hakkında daha fazla bilgi edinmek için veri yerleşimi ve gizlilik sayfasına bakın.

2024'te müşterilerin süresiz ileti saklama veya 90 gün sonra otomatik silme arasında seçim yapması gereken yeni işlevler sunulacaktır. Mevcut iletiler etkilenmez.

Sanal randevuları kullanan müşteriler için Teams toplantılarında sohbet iletilerinin depolanması için Teams Birlikte Çalışabilirlik kullanıcı gizliliğimize bakın.

Hizmet sınırları

Sohbet yazışmasında izin verilen katılımcı sayısı üst sınırı 250'dir.
İzin verilen ileti boyutu üst sınırı yaklaşık 28 KB'tır.
20'den fazla katılımcıya sahip sohbet yazışmaları için okundu bilgileri ve yazma göstergesi özellikleri desteklenmez.
Teams Birlikte Çalışma senaryolarında, yazma göstergesi özelliğinin desteklenmesi için 20'nin altında olması gereken, Teams kullanıcıları değil Azure İletişim Hizmetleri kullanıcı sayısıdır.
Teams Birlikte Çalışma senaryolarında, yazma göstergesi olayı Teams kullanıcısından gönderildiğinde boş bir görünen ad içerebilir.
Teams Birlikte Çalışma senaryolarında, teams kullanıcıları için okundu bilgileri desteklenmez.

Sohbet mimarisi

Sohbet mimarisinin iki temel bölümü vardır: 1) Güvenilen Hizmet ve 2) İstemci Uygulaması.

Diagram showing Communication Services' chat architecture.

Güvenilen hizmet: Sohbet oturumunuzu düzgün bir şekilde yönetmek için, kaynak bağlantı dizesi kullanarak İletişim Hizmetleri'ne bağlanmanıza yardımcı olan bir hizmete ihtiyacınız vardır. Bu hizmet sohbet yazışmaları oluşturmak, katılımcı ekleyip kaldırmak ve kullanıcılara erişim belirteçleri vermekle sorumludur. Erişim belirteçleri hakkında daha fazla bilgiyi erişim belirteçleri hızlı başlangıcımızda bulabilirsiniz.
İstemci uygulaması: İstemci uygulaması güvenilen hizmetinize bağlanır ve doğrudan İletişim Hizmetleri'ne bağlanmak için kullanıcılar tarafından kullanılan erişim belirteçlerini alır. Sohbet yazışmasını oluşturduktan ve kullanıcıları katılımcı olarak ekledikten sonra, sohbet yazışmasına bağlanmak ve ileti göndermek için istemci uygulamasını kullanabilirler. İstemci uygulamanızdaki gerçek zamanlı bildirimler, diğer katılımcıların ileti ve yazışma güncelleştirmelerine abone olmak için kullanılabilir.

Akıllı, yapay zeka destekli sohbet deneyimleri oluşturma

Aşağıdaki gibi kullanım örnekleri oluşturmak için Sohbet hizmetiyle Azure AI hizmetlerini kullanabilirsiniz:

Müşteriden gelen bir iletinin olumsuz yaklaşımını algılayarak destek temsilcisinin bilet önceliklerini belirlemesine yardımcı olun.
Sonraki adımlarla müşteriye e-posta yoluyla göndermek için konuşmanın sonunda bir özet oluşturun veya daha sonraki bir tarihte izleyin.
Azure Botu ve geçiş botu ile bir Azure İletişim Hizmetleri Sohbet kanalına Power Virtual Agent (PVA) ekleyin.
Botu Sohbet kanalının yanında bir veya daha fazla sosyal kanalda çalışacak şekilde yapılandırın.

Diagram showing Azure Communication Services can be paired with Azure AI services.

İleti türleri

İleti geçmişinin bir parçası olarak, Sohbet kullanıcı tarafından oluşturulan iletileri ve sistem tarafından oluşturulan iletileri paylaşır.

Sistem iletileri,

sohbet yazışması güncelleştirildi
katılımcı eklendi veya kaldırıldı
sohbet yazışması konusu güncelleştirildi.

Sohbet yazışmasını aradığınızda List Messages veya Get Messages bir sohbet yazışmasında sonuç her iki tür iletiyi kronolojik sırada içerir. Kullanıcı tarafından oluşturulan iletiler için, sohbet yazışmasına ileti gönderilirken ileti türü ayarlanabilir SendMessageOptions . Değer sağlanmazsa, İletişim Hizmetleri varsayılan olarak yazılır text . HTML gönderilirken bu değerin ayarlanması önemlidir. belirtildiğinde html , İletişim Hizmetleri içeriğin istemci cihazlarda güvenli bir şekilde işlendiğinden emin olmak için içeriği temizler.

text: Kullanıcı tarafından sohbet yazışmasının bir parçası olarak oluşturulan ve gönderilen düz metin iletisi.
html: Sohbet yazışmasının bir parçası olarak bir kullanıcı tarafından oluşturulan ve gönderilen html kullanılarak biçimlendirilmiş bir ileti.

Sistem iletisi türleri:

participantAdded: Sohbet yazışmasına bir veya daha fazla katılımcının eklendiğini gösteren sistem iletisi.
participantRemoved: Bir katılımcının sohbet yazışmasından kaldırıldığını belirten sistem iletisi.
topicUpdated: İş parçacığı konusunun güncelleştirildiğini belirten sistem iletisi.

Gerçek zamanlı bildirimler

JavaScript Sohbet SDK'sı gerçek zamanlı bildirimleri destekler. Bu özellik, istemcilerin API'leri yoklamadan gerçek zamanlı güncelleştirmeler ve sohbet yazışmasına gelen iletiler için İletişim Hizmetleri'ni dinlemesine olanak tanır.

İstemci uygulaması aşağıdaki olaylara abone olabilir:

chatMessageReceived - katılımcı tarafından sohbet yazışmasına yeni bir ileti gönderildiğinde.
chatMessageEdited - sohbet yazışmasında bir ileti düzenlendiğinde.
chatMessageDeleted - sohbet yazışmasında bir ileti silindiğinde.
typingIndicatorReceived - başka bir katılımcı sohbet yazışmasına bir yazma göstergesi gönderdiğinde.
readReceiptReceived - başka bir katılımcı okuduğu bir ileti için okundu bilgisi gönderdiğinde.
chatThreadCreated - bir İletişim Hizmetleri kullanıcısı bir sohbet yazışması oluşturduğunda.
chatThreadDeleted - bir İletişim Hizmetleri kullanıcısı bir sohbet yazışması sildiğinde.
chatThreadPropertiesUpdated - sohbet yazışması özellikleri güncelleştirildiğinde; şu anda yalnızca iş parçacığı için konu güncelleştirilmesi desteklenmektedir.
participantsAdded - kullanıcı sohbet yazışması katılımcısı olarak eklendiğinde.
participantsRemoved - mevcut bir katılımcı sohbet yazışmasından kaldırıldığında.
realTimeNotificationConnected - gerçek zamanlı bildirim bağlandığında.
realTimeNotificationDisconnected -gerçek zamanlı bildirimin bağlantısı kesildiğinde.

Dekont

Gerçek zamanlı bildirimler sunucu uygulamalarıyla kullanılmaz.

Sunucu olayları

Bu özellik, sunucu uygulamalarının bir ileti gönderildiğinde ve bir katılımcı sohbete katıldığında veya sohbette ayrıldığında gibi olayları dinlemesine olanak tanır. Sunucu uygulamaları bu olaylara tepki verebilir, sohbete katılımcı ekleyebilir/kaldırabilir, sohbetleri arşivleyebilir, analiz yapabilir ve düzenleme için diğer birçok senaryoyu gerçekleştirebilir. Geliştiriciler tarafından hangi tür sohbet olaylarının kullanılabileceğini görmek için bkz . Sunucu Olayları.

Anında iletme bildirimleri

Android ve iOS Sohbet SDK'ları anında iletme bildirimlerini destekler. Kullanıcılarınız dışarıdayken kaçırdığı iletiler için anında iletme bildirimleri göndermek için İletişim Hizmetleri kaynağıyla bir Bildirim Hub'ı kaynağına bağlanarak anında iletme bildirimleri gönderin. Bunu yaptığınızda, mobil uygulama ön planda çalışmadığında uygulama kullanıcılarınıza gelen sohbetler ve iletiler hakkında bilgi verilecektir.

IOS ve Android SDK aşağıdaki olayı destekler:

chatMessageReceived - katılımcı tarafından sohbet yazışmasına yeni bir ileti gönderildiğinde.

Android SDK ek olayları destekler:

chatMessageEdited - sohbet yazışmasında bir ileti düzenlendiğinde.
chatMessageDeleted - sohbet yazışmasında bir ileti silindiğinde.
chatThreadCreated - bir İletişim Hizmetleri kullanıcısı bir sohbet yazışması oluşturduğunda.
chatThreadDeleted - bir İletişim Hizmetleri kullanıcısı bir sohbet yazışması sildiğinde.
chatThreadPropertiesUpdated - sohbet yazışması özellikleri güncelleştirildiğinde; şu anda yalnızca iş parçacığı için konu güncelleştirilmesi desteklenmektedir.
participantsAdded - kullanıcı sohbet yazışması katılımcısı olarak eklendiğinde.
participantsRemoved - mevcut bir katılımcı sohbet yazışmasından kaldırıldığında.

Daha fazla bilgi için bkz . Anında İletme Bildirimleri.