Aracılığıyla paylaş

Teams Birlikte Çalışabilirliği: Arama

  • Makale

Önemli

Bu makalede açıklanan işlevsellik şu anda genel önizleme aşamasındadır. Bu önizleme sürümü hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için bu sürümü önermeyiz. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri Ek Kullanım Koşulları.

Bu önizlemenin bir parçası olarak, Azure İletişim Hizmetleri SDK'ları kendi kimliğinizi getirin (BYOI) kullanıcılarının Teams kullanıcıları ile 1:1 çağrıları başlatmasını sağlayan uygulamalar oluşturmak için kullanılabilir. Standart Azure İletişim Hizmetleri fiyatlandırması bu kullanıcılar için geçerlidir, ancak birlikte çalışabilirlik özelliği için ek ücret alınmaz. Teams kullanıcılarına veya Teams sesli uygulamalarına bağlanmak ve iletişim kurmak için Azure İletişim Hizmetleri ile oluşturulan özel uygulamalar son kullanıcılar veya botlar tarafından kullanılabilir ve uygulamanın geliştiricisi tarafından görünen adla açıkça belirtilmediği sürece Teams uygulamalarında Teams kullanıcılarına nasıl göründüklerinde bir fark yoktur.

İletişim Hizmetleri kullanıcılarınız ve Teams kiracınız arasında çağrıyı etkinleştirmek için, form üzerinden kiracınıza izin verin ve kiracı ile İletişim Hizmetleri kaynağı arasındaki bağlantıyı etkinleştirin.

Teams kiracınızda birlikte çalışabilirliği etkinleştirme

Teams yönetici rolüne sahip Microsoft Entra kullanıcısı, kiracıdaki İletişim Hizmetleri kaynağını etkinleştirmek için MicrosoftTeams modülüyle PowerShell cmdlet'ini çalıştırabilir.

1. Microsoft Teams modülünü hazırlama

İlk olarak, Aşağıdaki komutla PowerShell'i açın ve Teams modülünün varlığını doğrulayın:

Get-module *teams*

Modülü görmüyorsanız MicrosoftTeams önce yükleyin. Modülü yüklemek için PowerShell'i yönetici olarak çalıştırmanız gerekir. Sonra şu komutu çalıştırın:

	Install-Module -Name MicrosoftTeams

Yüklenecek modüller hakkında bilgilendirilirsiniz ve bunu bir Y veya A yanıtıyla onaylayabilirsiniz. Modül yüklüyse ancak eskiyse, modülü güncelleştirmek için aşağıdaki komutu çalıştırabilirsiniz:

	Update-Module MicrosoftTeams

2. Microsoft Teams modülüne Bağlan

Modül yüklenip hazır olduğunda, aşağıdaki komutu kullanarak MicrosftTeams modülüne bağlanabilirsiniz. Oturum açmanız için etkileşimli bir pencere istenir. Kullanacağınız kullanıcı hesabının Teams yönetici izinlerine sahip olması gerekir. Aksi takdirde, sonraki adımlarda bir access denied yanıt alabilirsiniz.

Connect-MicrosoftTeams

3. Kiracı yapılandırmasını etkinleştirme

İletişim Hizmetleri kaynaklarıyla birlikte çalışabilirlik, kiracı yapılandırması ve atanan ilke aracılığıyla denetlenebilir. Teams kiracısı tek bir kiracı yapılandırmasına sahiptir ve Teams kullanıcıları genel ilke veya özel ilke atamıştır. Daha fazla bilgi için bkz . Teams'de İlke Atama.

Başarılı bir oturum açma işleminden sonra, kiracınızda İletişim Hizmetleri kaynağını etkinleştirmek için Set-CsTeamsAcsFederationConfiguration cmdlet'ini çalıştırabilirsiniz. Metni IMMUTABLE_RESOURCE_ID iletişim kaynağınızda sabit bir kaynak kimliğiyle değiştirin. Bu bilgileri nasıl edinebileceğiniz hakkında daha fazla bilgiyi burada bulabilirsiniz.

$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist

4. Kiracı ilkesini etkinleştirme

Her Teams kullanıcısı, İletişim Hizmetleri kullanıcılarının bu Teams kullanıcısını çağırıp çağıramayacağını belirleyen bir External Access Policy atamıştır. Teams kullanıcısına atanan ilkenin olarak ayarlandığından EnableAcsFederationAccess emin olmak için Set-CsExternalAccessPolicy cmdlet'ini kullanın$true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Teams kullanıcı kimliğini alma

Teams kullanıcısı veya Teams Voice uygulamasıyla arama başlatmak için hedefin tanımlayıcısına sahip olmanız gerekir. Kimliği almak için aşağıdaki seçeneklere sahipsiniz:

Arama

Arama SDK'sı ile, bir İletişim Hizmetleri kullanıcısı veya uç noktası, Microsoft Entra nesne kimliğiyle tanımlanan Teams kullanıcılarıyla 1:1 çağrısı başlatabilir. Teams kullanıcılarını aramak için diğer İletişim Hizmetleri kullanıcılarını çağıran mevcut bir uygulamayı kolayca değiştirebilirsiniz.

Aramaları yönetme - Azure İletişim Hizmetleri nasıl yapılır kılavuzu | Microsoft Docs

communicationUserId kullanarak başka bir İletişim Hizmetleri uç noktasını çağırma:

const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);

MicrosoftTeamsUserId kullanarak Teams kullanıcılarını çağırma:

const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);

Sesli ve görüntülü arama etkinlikleri

İletişim Hizmetleri sesli ve görüntülü arama olayları , bir İletişim Hizmetleri kullanıcısı ile Teams kullanıcıları arasındaki aramalar için oluşturulur.

Sınırlamalar ve bilinen sorunlar

  • Bu işlev şu anda .NET Arama SDK'sında kullanılamaz.
  • Teams kullanıcıları "TeamsOnly" modunda olmalıdır. Skype Kurumsal kullanıcıları İletişim Hizmetleri kullanıcılarından 1:1 çağrıları alamaz.
  • Grup çağrısına yükseltme desteklenmez.
  • İletişim Hizmetleri arama kaydı 1:1 aramaları için kullanılamaz.
  • Arama iletme, grup araması teslim alma, aynı anda çaldırma ve sesli mesaj gibi gelişmiş arama yönlendirme özellikleri desteklenmez.
  • Teams kullanıcıları İletişim Hizmetleri kullanıcılarını iletme/aktarma hedefleri olarak ayarlayamaz.
  • Teams istemcisindeki birçok özellik, İletişim Hizmetleri kullanıcılarıyla yapılan 1:1 çağrıları sırasında beklendiği gibi çalışmaz.
  • Teams ve Skype IP telefonları için üçüncü taraf cihazlar desteklenmez.

Gizlilik

Azure İletişim Hizmetleri ve Microsoft Teams arasında birlikte çalışabilirlik, uygulamalarınızın ve kullanıcılarınızın Teams aramalarına ve toplantılarına katılmasını sağlar. Bir Teams çağrısında veya toplantısında kayıt veya transkripsiyon etkinleştirildiğinde, uygulamanızdaki kullanıcıların bu konuda bilgilendirilmesini sağlamak sizin sorumluluğunuzdadır.

Microsoft, Azure İletişim Hizmetleri API aracılığıyla kayıt veya transkripsiyonun başlatıldığını belirtir. Bu gerçeği uygulamanızın kullanıcı arabirimindeki kullanıcılarınıza gerçek zamanlı olarak iletmeniz gerekir. Bu yükümlülüğe uymamanızdan kaynaklanan tüm maliyetler ve zararlar için Microsoft'u tazmini kabul edersiniz.