Condividi tramite

Interoperabilità di Teams: chiamata

  • Articolo

Importante

Attualmente la funzionalità descritta in questo articolo è disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto se ne sconsiglia l’uso per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Nell'ambito di questa anteprima, gli SDK di Servizi di comunicazione di Azure possono essere usati per creare applicazioni che consentono agli utenti byoI (Bring Your Own Identity) di avviare chiamate 1:1 con gli utenti di Teams. I prezzi standard Servizi di comunicazione di Azure si applicano a questi utenti, ma non sono previsti costi aggiuntivi per la funzionalità di interoperabilità. Le applicazioni personalizzate create con Servizi di comunicazione di Azure per connettersi e comunicare con gli utenti di Teams o le applicazioni vocali di Teams possono essere usate dagli utenti finali o dai bot e non esiste alcuna differenziazione nel modo in cui appaiono agli utenti di Teams nelle applicazioni Teams, a meno che non venga esplicitamente indicato dallo sviluppatore dell'applicazione con un nome visualizzato.

Per abilitare la chiamata tra gli utenti di Servizi di comunicazione e il tenant di Teams, consentire il tenant tramite il modulo e abilitare la connessione tra il tenant e la risorsa servizi di comunicazione.

Abilitare l'interoperabilità nel tenant di Teams

L'utente Di Microsoft Entra con il ruolo di amministratore di Teams può eseguire il cmdlet di PowerShell con il modulo MicrosoftTeams per abilitare la risorsa servizi di comunicazione nel tenant.

1. Preparare il modulo di Microsoft Teams

Prima di tutto, aprire PowerShell e convalidare l'esistenza del modulo Teams con il comando seguente:

Get-module *teams*

Se il modulo non viene visualizzato MicrosoftTeams , installarlo per primo. Per installare il modulo, è necessario eseguire PowerShell come amministratore. Poi eseguire quindi il comando seguente.

	Install-Module -Name MicrosoftTeams

Verranno informati sui moduli che verranno installati, che è possibile confermare con una Y risposta o A . Se il modulo è installato ma non aggiornato, è possibile eseguire il comando seguente per aggiornare il modulo:

	Update-Module MicrosoftTeams

2. Connettersi al modulo di Microsoft Teams

Quando il modulo è installato e pronto, è possibile connettersi al modulo MicrosoftTeams con il comando seguente. Verrà visualizzata una finestra interattiva per l'accesso. L'account utente che si intende usare deve avere le autorizzazioni di amministratore di Teams. In caso contrario, è possibile ottenere una access denied risposta nei passaggi successivi.

Connect-MicrosoftTeams

3. Abilitare la configurazione del tenant

L'interoperabilità con le risorse di Servizi di comunicazione viene controllata tramite la configurazione del tenant e i criteri assegnati. Il tenant di Teams ha una configurazione a tenant singolo e gli utenti di Teams hanno assegnato criteri globali o criteri personalizzati. Per altre informazioni, vedere Assegnare criteri in Teams.

Al termine dell'accesso, è possibile eseguire il cmdlet Set-CsTeamsAcsFederationConfiguration per abilitare la risorsa servizi di comunicazione nel tenant. Sostituire il testo IMMUTABLE_RESOURCE_ID con un ID risorsa non modificabile nella risorsa di comunicazione. Per altri dettagli su come ottenere queste informazioni , vedere qui.

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

4. Abilitare i criteri del tenant

A ogni utente di Teams è stato assegnato un oggetto External Access Policy che determina se gli utenti di Servizi di comunicazione possono chiamare l'utente di Teams. Usare il cmdlet Set-CsExternalAccessPolicy per assicurarsi che i criteri assegnati all'utente di Teams siano impostati su EnableAcsFederationAccess$true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Ottenere l'ID utente di Teams

Per avviare una chiamata con un utente di Teams o un'applicazione Teams Voice, è necessario un identificatore della destinazione. Sono disponibili le opzioni seguenti per recuperare l'ID:

Chiamata in corso

Con l'SDK chiamante, un utente o un endpoint di Servizi di comunicazione può avviare una chiamata 1:1 con gli utenti di Teams, identificati dal relativo ID oggetto Microsoft Entra. È possibile modificare facilmente un'applicazione esistente che chiama altri utenti di Servizi di comunicazione per chiamare gli utenti di Teams.

Gestire le chiamate - Guida pratica Servizi di comunicazione di Azure | Microsoft Docs

Chiamata di un altro endpoint di Servizi di comunicazione tramite communicationUserId:

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

Chiamata di un utente di Teams tramite microsoftTeamsUserId:

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

Eventi di chiamate vocali e video

Gli eventi vocali e videochiamate di Servizi di comunicazione vengono generati per le chiamate tra un utente di Servizi di comunicazione e gli utenti di Teams.

Limitazioni e problemi noti

  • Questa funzionalità non è attualmente disponibile in .NET Calling SDK.
  • Gli utenti di Teams devono essere in modalità "TeamsOnly". Gli utenti di Skype for Business non possono ricevere chiamate 1:1 dagli utenti di Servizi di comunicazione.
  • L'escalation a una chiamata di gruppo non è supportata.
  • La registrazione delle chiamate di Servizi di comunicazione non è disponibile per le chiamate 1:1.
  • Le funzionalità avanzate di routing delle chiamate, ad esempio l'inoltro delle chiamate, il ritiro delle chiamate di gruppo, l'anello simultaneo e la segreteria telefonica non sono supportate.
  • Gli utenti di Teams non possono impostare gli utenti di Servizi di comunicazione come destinazioni di inoltro/trasferimento.
  • Molte funzionalità del client di Teams non funzionano come previsto durante le chiamate 1:1 con gli utenti di Servizi di comunicazione.
  • I dispositivi di terze parti per i telefoni IP Di Teams e Skype non sono supportati.

Riservatezza

L'interoperabilità tra Servizi di comunicazione di Azure e Microsoft Teams consente alle applicazioni e agli utenti di partecipare alle chiamate e alle riunioni di Teams. È responsabilità della Società garantire che gli utenti della sua applicazione siano avvisati quando la registrazione o la trascrizione è abilitata durante una chiamata o una riunione di Teams.

Microsoft indicherà tramite l'API Servizi di comunicazione di Azure che è iniziata la registrazione o la trascrizione. È necessario comunicare questo fatto in tempo reale agli utenti all'interno dell'interfaccia utente dell'applicazione. L'utente accetta di indennizzare Microsoft per tutti i costi sostenuti e i danni a causa del mancato rispetto dell'obbligo.