Sohbet kavramları

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, denetiminizde olan chat threads Azure hizmetinde kimlik doğrulaması yapmak ve birbirleriyle iletişim kurmak için bu kimlikleri kullanır.
  • Şifreleme - Sohbet SDK'ları trafiği şifreler ve aktarım sırasında kurcalanması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 bildirimler ("toasts" olarak bilinir) başlatmaya 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ının kimliği şudur 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, yazışma oluşturulduğunda geçerli olan veri saklama ilkesine göre sohbet yazışmalarını depolar. Bekletme ilkesini, ayarladığınız bekletme süresi boyunca gerekirse güncelleştirebilirsiniz. Sohbet yazışmasını sildikten sonra (politikaya veya Silme API'si isteğine göre) geri alınamaz.

Şunlar arasında seçim yapabilirsiniz:

Yeni bekletme ilkesinden önce oluşturulan herhangi bir iş parçacığı, o iş parçacığı için ilkeyi özellikle değiştirmediğiniz sürece etkilenmez. Saklama politikası bu sohbet dizisini sildikten 30 günden daha uzun bir süre geçtiyse ve bu durumda silinen bir sohbet dizisi için destek isteği gönderirseniz, bu diziyi artık geri getirmek mümkün değildir ve bu dizili hakkında bilgi bulunmamaktadır. Gerekirse, bir konu oluşturduktan sonraki 30 gün içinde mümkün olan en kısa sürede size yardımcı olabilmemiz için bir destek bileti açın.

Belirli bir sohbet yazışmasının ileti geçmişini görüntülemek için katılımcılar ListMessages kullanabilir. Konu silinirse, ListMessages API'si bir konunun geçmişini döndüremez. 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 bkz. Bölge kullanılabilirliği ve veri yerleşimi.

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 konuları için okunma bilgisi izleme ve yazma göstergesi özellikleri desteklenmemektedir.
  • Takımların birlikte çalışabilirlik senaryolarında, yazma göstergesi özelliğinin desteklenebilmesi için 20'nin altında olması gereken, Teams kullanıcıları değil, Azure İletişim Hizmetleri kullanıcıları sayısıdır.
  • Sohbet yazışması oluştururken bekletme ilkesini 30 ile 90 gün arasında ayarlayabilirsiniz.
  • Ayrıca, Teams Birlikte Çalışma senaryolarında aşağıdaki sınırlamalar vardır:

Sohbet mimarisi

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

İletişim Hizmetleri'nin sohbet mimarisini gösteren diyagram.

  • 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. Daha fazla bilgi için Hızlı Başlangıç: Erişim belirteçleri oluşturma ve yönetme hızlı başlangıcına bakın.
  • İstemci uygulaması: İstemci uygulaması güvenilen hizmetinize bağlanır ve kullanıcıların doğrudan İletişim Hizmetleri'ne bağlanması gereken erişim belirteçlerini alır. Sohbet yazışmasını oluşturup katılımcı ekledikten sonra, sohbet yazışmasına bağlanmak ve ileti göndermek için istemci uygulamasını kullanabilirler. Katılımcılar, diğer üyelerden gelen ileti ve yazışma güncelleştirmelerine abone olmak için istemci uygulamanızda gerçek zamanlı bildirimleri kullanabilir.

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

Aşağıdaki gibi kullanım örnekleri oluşturmak için Sohbet hizmetiyle Foundry Araçları'nı 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.
  • Bir Aracı, Azure Botu ve bir geçiş botu ile bir Azure İletişim Hizmetleri Sohbet kanalına ekleyin.
  • Botu Sohbet kanalının yanında bir veya daha fazla sosyal kanalda çalışacak şekilde yapılandırın.

Azure İletişim Hizmetleri'nin Döküm Araçları ile eşleştirilebileceğini gösteren diyagram.

İ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, ... oluşturulduğunda

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

Sohbet yazışmasında List Messages veya Get Messages'i çağırdığınızda sonuç, her iki tür iletiyi de kronolojik sırada içerir. Kullanıcı tarafından oluşturulan iletiler için, sohbet yazışmasına ileti gönderilirken ileti türü SendMessageOptions içinde ayarlanabilir. Değer sağlanmazsa, İletişim Hizmetleri varsayılan olarak text türüne ayarlanır. HTML gönderilirken bu değerin ayarlanması önemlidir. belirtildiğinde html İletişim Hizmetleri, 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: Bir veya daha fazla katılımcının sohbet yazışmasında olduğunu belirten 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üncellendiğ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ı, okudukları mesaja ilişkin 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 dizisi özellikleri güncellendiğinde; şu anda yalnızca dizinin konusu güncellenmesi 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.

Uyarı

Sunucu uygulamalarıyla gerçek zamanlı bildirimler kullanmayın.

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ştiricilerin kullanabileceği sohbet olaylarını görmek için Azure Event Grid kaynağı olarak Azure İletişim Hizmetleri bölümüne bakın.

Anında iletme bildirimleri

Android ve iOS Sohbet SDK'ları anında iletme bildirimlerini destekler. Katılımcılarınız dışarıdayken kaçırdıkları iletiler için anında iletme bildirimleri göndermek için İletişim Hizmetleri kaynağına bir Notification Hub kaynağı bağlayarak anında iletme bildirimleri gönderin. Bunu yaptığınızda, mobil uygulama ön planda çalışmadığında uygulama katılımcılarına gelen sohbetler ve iletiler hakkında bilgi gönderilir.

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

  • chatMessageReceived - bir katılımcı sohbet yazışmasına yeni bir ileti gönderdiğinde.

Android SDK ek olayları destekler:

  • chatMessageEdited - bir katılımcı sohbet yazışmasında bir iletiyi düzenlediğinde.
  • chatMessageDeleted - bir katılımcı sohbet yazışmasında bir iletiyi sildiğ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ı özelliklerini güncelleştirdiğinizde; şimdilik yalnızca başlık güncelleştirilmesi desteklenmektedir.
  • participantsAdded - sohbet yazışmasına katılımcı eklediğinizde.
  • participantsRemoved - mevcut bir katılımcıyı sohbet yazışmasından kaldırdığınızda.

Daha fazla bilgi için Anında İletme Bildirimleri bölümüne bakın.

Uyarı

Şu anda Notification Hub ile sohbet anında iletme bildirimleri göndermek, Android sürüm 1.1.0 ve IOS sürüm 1.3.0'da genel kullanıma sunulmuştur.

Sonraki adımlar

Sohbeti kullanmaya başlama

  • Last updated on