Teams-interoperabiliteit: bellen
Belangrijk
De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview. Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.
Als onderdeel van deze preview kunnen de AZURE Communication Services SDK's worden gebruikt om toepassingen te bouwen waarmee BYOI-gebruikers (Bring Your Own Identity) 1:1-oproepen kunnen starten met Teams-gebruikers. De prijzen van Standard Azure Communication Services zijn van toepassing op deze gebruikers, maar er zijn geen extra kosten verbonden aan de interoperabiliteitsmogelijkheid. Aangepaste toepassingen die zijn gebouwd met Azure Communication Services om verbinding te maken en te communiceren met Teams-gebruikers of Teams-spraaktoepassingen kunnen worden gebruikt door eindgebruikers of bots, en er is geen differentiatie in hoe ze voor Teams-gebruikers in Teams-toepassingen lijken, tenzij expliciet aangegeven door de ontwikkelaar van de toepassing met een weergavenaam.
Als u gesprekken tussen uw Communication Services-gebruikers en Teams-tenant wilt inschakelen, staat u uw tenant via het formulier toe en schakelt u de verbinding tussen de tenant en de Communication Services-resource in.
Interoperabiliteit inschakelen in uw Teams-tenant
Microsoft Entra-gebruiker met de beheerdersrol Teams kan PowerShell-cmdlet uitvoeren met de MicrosoftTeams-module om de Communication Services-resource in de tenant in te schakelen.
1. De Microsoft Teams-module voorbereiden
Open eerst PowerShell en valideer het bestaan van de Teams-module met de volgende opdracht:
Get-module *teams*
Als u de module niet ziet, installeert u deze MicrosoftTeams
eerst. Als u de module wilt installeren, moet u PowerShell uitvoeren als beheerder. Voer vervolgens de volgende opdracht uit:
Install-Module -Name MicrosoftTeams
U wordt geïnformeerd over de modules die worden geïnstalleerd, die u kunt bevestigen met een Y
of A
meer antwoorden. Als de module is geïnstalleerd maar verouderd is, kunt u de volgende opdracht uitvoeren om de module bij te werken:
Update-Module MicrosoftTeams
2. Verbinding maken met microsoft Teams-module
Wanneer de module is geïnstalleerd en gereed is, kunt u verbinding maken met de MicrosoftTeams-module met de volgende opdracht. U wordt gevraagd om u aan te melden met een interactief venster. Het gebruikersaccount dat u gaat gebruiken, moet beschikken over beheerdersmachtigingen voor Teams. Anders krijgt u mogelijk een access denied
antwoord in de volgende stappen.
Connect-MicrosoftTeams
3. Tenantconfiguratie inschakelen
Interoperabiliteit met Communication Services-resources wordt beheerd via tenantconfiguratie en toegewezen beleid. Teams-tenant heeft één tenantconfiguratie en Teams-gebruikers hebben globaal beleid of aangepast beleid toegewezen. Zie Beleid toewijzen in Teams voor meer informatie.
Nadat u zich hebt aangemeld, kunt u de cmdlet Set-CsTeamsAcsFederationConfiguration uitvoeren om de Communication Services-resource in uw tenant in te schakelen. Vervang de tekst IMMUTABLE_RESOURCE_ID
door een onveranderbare resource-id in uw communicatieresource. Hier vindt u meer informatie over hoe u deze informatie kunt verkrijgen.
$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist
4. Tenantbeleid inschakelen
Elke Teams-gebruiker heeft een External Access Policy
toegewezen die bepaalt of Communication Services-gebruikers deze Teams-gebruiker kunnen aanroepen. Gebruik cmdlet Set-CsExternalAccessPolicy om ervoor te zorgen dat het beleid dat is toegewezen aan de Teams-gebruiker is ingesteld op EnableAcsFederationAccess
$true
Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true
Gebruikers-id van Teams ophalen
Als u een gesprek wilt starten met een Teams-gebruiker of Teams Voice-toepassing, hebt u een id van het doel nodig. U hebt de volgende opties om de id op te halen:
- Gebruikersinterface van Microsoft Entra ID of met on-premises adreslijstsynchronisatie Microsoft Entra Connect
- Programmatisch via Microsoft Graph API
Bellen
Met de Calling SDK kan een Communication Services-gebruiker of -eindpunt een 1:1-aanroep starten met Teams-gebruikers, geïdentificeerd door hun Microsoft Entra-object-id. U kunt eenvoudig een bestaande toepassing wijzigen die andere Communication Services-gebruikers aanroept om Teams-gebruikers aan te roepen.
Aanroepen beheren - Een handleiding voor Azure Communication Services | Microsoft Docs
Een ander Communication Services-eindpunt aanroepen met communicationUserId:
const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);
Een Teams-gebruiker aanroepen met behulp van microsoftTeamsUserId:
const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);
Gebeurtenissen voor spraak- en videogesprekken
Communicatieservices voor spraak- en videogesprekken worden gegenereerd voor gesprekken tussen een Communication Services-gebruiker en Teams-gebruikers.
Beperkingen en bekende problemen
- Deze functionaliteit is momenteel niet beschikbaar in de .NET Calling SDK.
- Teams-gebruikers moeten zich in de modus TeamsOnly bevinden. Skype voor Bedrijven gebruikers kunnen geen 1:1-oproepen ontvangen van Communication Services-gebruikers.
- Escalatie naar een groepsgesprek wordt niet ondersteund.
- Communication Services-oproepopname is niet beschikbaar voor 1:1-oproepen.
- Geavanceerde mogelijkheden voor het routeren van gesprekken, zoals het doorschakelen van gesprekken, het ophalen van groepsgesprekken, gelijktijdig bellen en voicemail, worden niet ondersteund.
- Teams-gebruikers kunnen Communication Services-gebruikers niet instellen als doorstuur-/overdrachtsdoelen.
- Veel functies in de Teams-client werken niet zoals verwacht tijdens 1:1-gesprekken met Communication Services-gebruikers.
- Apparaten van derden voor Teams - en Skype-IP-telefoons worden niet ondersteund.
Privacy
Dankzij interoperabiliteit tussen Azure Communication Services en Microsoft Teams kunnen uw toepassingen en gebruikers deelnemen aan Teams-oproepen en -vergaderingen. Het is uw verantwoordelijkheid om ervoor te zorgen dat de gebruikers van uw toepassing op de hoogte worden gesteld wanneer opname of transcriptie is ingeschakeld in een Teams-gesprek of -vergadering.
Microsoft geeft aan via de Azure Communication Services-API dat de opname of transcriptie is gestart. U moet dit feit in realtime doorgeven aan uw gebruikers in de gebruikersinterface van uw toepassing. U stemt ermee in om Microsoft te vergoeden voor alle kosten en schade die zijn ontstaan door uw niet-naleving van deze verplichting.