Freigeben über

Teams-Interoperabilität: Anrufe

  • Artikel

Wichtig

Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Im Rahmen dieser Vorschau können die Azure Communication Services SDKs verwendet werden, um Anwendungen zu erstellen, die es BYOI-Nutzern ermöglichen, 1:1-Anrufe mit Teams-Nutzern zu starten. Für diese Nutzer gelten die üblichen Azure Communication Services-Preise, aber für die Interoperabilitätsfunktion selbst fallen keine zusätzlichen Gebühren an. Benutzerdefinierte Anwendungen, die mit Azure Communication Services erstellt wurden, um mit Teams-Benutzern oder Teams-VoIP-Anwendungen zu verbinden und zu kommunizieren, können von Endbenutzern oder Bots verwendet werden, und es gibt keine Differenzierung, wie sie Microsoft Teams-Benutzern in Teams-Anwendungen angezeigt werden, es sei denn, der Entwickler der Anwendung hat es mit einem Anzeigenamen explizit angegeben.

Um Anrufe zwischen Ihren Communication Services-Benutzern und dem Teams-Mandanten zu ermöglichen, lassen Sie Ihren Mandanten über das Formular zu und aktivieren sie die Verbindung zwischen der Ressource „Mandanten“ und „Communication Services“.

Aktivieren der Interoperabilität in Ihrem Teams-Mandanten

Microsoft Entra-Benutzer mit der Teams-Administratorrolle können das PowerShell-Cmdlet mit dem MicrosoftTeams-Modul ausführen, um die Communication Services-Ressource im Mandanten zu aktivieren.

1. Vorbereiten des Microsoft Teams-Moduls

Öffnen Sie zunächst die PowerShell, und überprüfen Sie das Vorhandensein des Teams-Moduls mit dem folgenden Befehl:

Get-module *teams*

Wenn das MicrosoftTeams-Modul nicht angezeigt wird, installieren Sie es zuerst. Um das Modul zu installieren, müssen Sie PowerShell als Administrator ausführen. Führen Sie dann den folgenden Befehl aus:

	Install-Module -Name MicrosoftTeams

Sie werden über die Module informiert, die installiert werden, die Sie mit der Antwort Y oder A bestätigen können. Wenn das Modul installiert, aber veraltet ist, können Sie den folgenden Befehl ausführen, um das Modul zu aktualisieren:

	Update-Module MicrosoftTeams

2. Herstellen einer Verbindung mit dem Microsoft Teams-Modul

Wenn das Modul installiert und bereit ist, können Sie mit dem folgenden Befehl eine Verbindung mit dem MicrosftTeams-Modul herstellen. Sie werden aufgefordert, sich mit einem interaktiven Fenster anzumelden. Das Benutzerkonto, das Sie verwenden möchten, muss über Teams-Administratorberechtigungen verfügen. Andernfalls erhalten Sie möglicherweise in den nächsten Schritten die Antwort access denied.

Connect-MicrosoftTeams

3. Aktivieren der Mandantenkonfiguration

Die Interoperabilität mit Communication Services-Ressourcen wird über die Mandantenkonfiguration und die zugewiesene Richtlinie gesteuert. Der Teams-Mandant verfügt über eine einzelne Mandantenkonfiguration, und Teams-Benutzer*innen wurde eine globale Richtlinie oder eine benutzerdefinierte Richtlinie zugewiesen. Weitere Informationen finden Sie unter Zuweisen von Richtlinien in Teams.

Nach erfolgreicher Anmeldung können Sie das Cmdlet Set-CsTeamsAcsFederationConfiguration ausführen, um die Communication Services-Ressource in Ihrem Mandanten zu aktivieren. Ersetzen Sie den Text IMMUTABLE_RESOURCE_ID durch eine unveränderliche Ressourcen-ID in Ihrer Kommunikationsressource. Weitere Informationen zum Abrufen dieser Informationen finden Sie hier.

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

4. Aktivieren der Mandantenrichtlinie

Jedem Teams-Benutzer wurde eine External Access Policy zugewiesen, die festlegt, ob Communication Services-Benutzer*innen diese Teams-Benutzer*in bzw. diesen Teams-Benutzer aufrufen können. Verwenden Sie das Cmdlet Set-CsExternalAccessPolicy, um sicherzustellen, dass für die der Teams-Benutzer*in bzw. dem Teams-Benutzer zugewiesene Richtlinie EnableAcsFederationAccess auf $true festgelegt ist

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Abrufen der Teams-Benutzer-ID

Um einen Anruf mit einem Teams-Benutzer oder einer Teams-VoIP-Anwendung zu starten, benötigen Sie einen Bezeichner des Ziels. Sie haben die folgenden Optionen zum Abrufen der ID:

Aufrufen

Mit dem Calling SDK kann ein Communication Services-Benutzer oder -Endpunkt einen 1:1-Anruf mit Teams-Benutzern starten, die durch ihre Microsoft Entra Objekt-ID identifiziert werden. Sie können eine bestehende Anwendung, die andere Benutzer der Kommunikationsdienste anruft, leicht ändern und einen Teams-Benutzer anrufen.

Anrufe verwalten - Eine Anleitung zu Azure Communication Services | Microsoft Docs

Aufrufen eines anderen Communication Services Endpunkts mit communicationUserId:

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

Aufrufen eines Teams-Benutzers mit microsoftTeamsUserId:

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

Ereignisse für Sprach- und Videoanrufe

Communication Services Sprach- und Videoanrufereignisse werden für Aufrufe zwischen einem Communication Services und Teams ausgelöst.

Einschränkungen und bekannte Probleme

  • Diese Funktionalität ist im .NET Calling SDK derzeit nicht verfügbar.
  • Teams-Benutzer müssen sich im Modus "TeamsOnly" befinden. Skype for Business-Nutzer können keine 1:1-Anrufe von Nutzern der Kommunikationsdienste entgegennehmen.
  • Die Eskalation zu einem Gruppenruf wird nicht unterstützt.
  • Die Gesprächsaufzeichnung der Kommunikationsdienste ist nicht für 1:1-Gespräche verfügbar.
  • Erweiterte Anrufweiterleitungsfunktionen wie Anrufweiterleitung, Gruppenrufübernahme, simultanes Klingeln und Voicemail werden nicht unterstützt.
  • Teams-Benutzer können keine Kommunikationsdienste-Benutzer als Weiterleitungs-/Übertragungsziele festlegen.
  • Viele Features im Teams-Client funktionieren bei 1:1-Anrufen mit Benutzern von Communication Services nicht wie erwartet.
  • Drittanbietergeräte für Teams und Skype IP-Telefone werden nicht unterstützt.

Datenschutz

Die Interoperabilität zwischen Azure Communication Services und Microsoft Teams ermöglicht Ihren Anwendungen und Benutzern, an Teams-Anrufen, -Besprechungen teilzunehmen. Sie sind dafür verantwortlich, dass die Benutzer Ihrer Anwendung benachrichtigt werden, wenn die Aufzeichnung oder Transkription in einem Teams-Anruf oder einer Teams-Besprechung aktiviert ist.

Microsoft gibt über die Azure Communication Services-API an, dass die Aufzeichnung oder Transkription begonnen hat. Sie müssen diese Tatsache in Echtzeit an Ihre Benutzer innerhalb der Benutzeroberfläche Ihrer Anwendung kommunizieren. Sie erklären sich damit einverstanden, Microsoft von allen Kosten und Schäden freizustellen, die aufgrund der Nichteinhaltung dieser Verpflichtung durch Sie entstehen.