Interoperabilidade do Teams: chamada

Como parte desta versão prévia, os SDKs dos Serviços de Comunicação do Azure podem ser usados para criar aplicativos que permitem que usuários que trazem sua própria identidade (BYOI) iniciem chamadas entre dois usuários do Teams. Os preços padrão dos Serviços de Comunicação do Azure se aplicam a esses usuários, mas não há nenhuma taxa extra para o recurso de interoperabilidade. Aplicativos personalizados criados com os Serviços de Comunicação do Azure para se conectar e se comunicar com usuários do Teams ou aplicativos de voz do Teams podem ser usados por usuários finais ou por bots, e não há nenhuma diferenciação em como eles aparecem para os usuários do Teams em aplicativos do Teams, a menos que explicitamente indicados pelo desenvolvedor do aplicativo com um nome de exibição.

Para habilitar a chamada entre os usuários dos Serviços de Comunicação e o locatário do Teams, permita o seu locatário por meio do formulário e habilite a conexão entre o locatário e o recurso dos Serviços de Comunicação.

Habilitar a interoperabilidade em seu locatário do Teams

O usuário do Microsoft Entra com função de administrador do Teams pode executar o cmdlet do PowerShell com o módulo MicrosoftTeams para habilitar o recurso Serviços de Comunicação no locatário.

1. Preparar o módulo do Microsoft Teams

Primeiro, abra o PowerShell e valide a existência do módulo do Teams com o seguinte comando:

Get-module *teams* 

Se você não vir o módulo MicrosoftTeams, instale-o primeiro. Para instalar o módulo, você precisa executar o PowerShell como administrador. Em seguida, execute o seguinte comando:

	Install-Module -Name MicrosoftTeams

Você será informado sobre os módulos que serão instalados, que podem ser confirmados com uma resposta Y ou A. Se o módulo estiver instalado, mas estiver desatualizado, você poderá executar o seguinte comando para atualizar o módulo:

	Update-Module MicrosoftTeams

2. Conectar-se ao módulo do Microsoft Teams

Quando o módulo estiver instalado e pronto, você poderá se conectar ao módulo MicrosftTeams com o comando a seguir. Você receberá uma solicitação com uma janela interativa para fazer logon. A conta de usuário que você usará precisa ter permissões de administrador do Teams. Caso contrário, você poderá obter uma resposta access denied nas próximas etapas.

Connect-MicrosoftTeams

3. Habilitar a configuração do locatário

A interoperabilidade com recursos dos Serviços de Comunicação é controlada por meio da configuração do locatário e da política atribuída. O locatário do Teams tem uma única configuração de locatário e os usuários do Teams têm atribuída a política global ou política personalizada. Para obter mais informações, consulte Políticas de atribuição no Teams.

Após o logon bem-sucedido, você pode executar o cmdlet Set-CsTeamsAcsFederationConfiguration para habilitar o recurso dos Serviços de Comunicação em seu locatário. Substitua o texto IMMUTABLE_RESOURCE_ID por uma ID de recurso imutável no recurso de comunicação. Você pode encontrar mais detalhes sobre como obter essas informações aqui.

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

4. Habilitar a política de locatário

Cada usuário do Teams atribuiu um External Access Policy que determina se os usuários dos Serviços de Comunicação podem chamar esse usuário do Teams. Use o cmdlet Set-CsExternalAccessPolicy para garantir que a política atribuída ao usuário do Teams tenha EnableAcsFederationAccess definido como $true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Obter a ID do usuário do Teams

Para iniciar uma chamada com um usuário do Teams ou aplicativo de voz do Teams, você precisa de um identificador do destino. Você tem as seguintes opções para recuperar a ID:

• Interface do usuário do Microsoft Entra ID ou com sincronização de diretório local do Microsoft Entra Connect
• Programaticamente por meio da API do Microsoft Graph

Chamando

Com o SDK de chamada, um usuário ou ponto de extremidade dos Serviços de Comunicação pode iniciar uma chamada entre dois usuários do Teams, identificados pela ID de objeto do Microsoft Entra. Você pode modificar facilmente um aplicativo existente que chama outros usuários dos Serviços de Comunicação para chamar usuários do Teams.

Gerenciar chamadas – um guia de instruções dos Serviços de Comunicação do Azure | Microsoft Docs

Chamando outro ponto de extremidade dos Serviços de Comunicação usando communicationUserId:

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

Chamando um usuário do Teams usando o microsoftTeamsUserId:

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

Eventos de chamadas de voz e vídeo

Os eventos de chamada de voz e vídeo dos Serviços de Comunicação são gerados para chamadas entre um usuário dos Serviços de Comunicação e usuários do Teams.

Limitações e problemas conhecidos

• No momento, esta funcionalidade não está disponível no SDK de chamada do .NET.
• Os usuários do Teams devem estar no modo "TeamsOnly". Os usuários do Skype for Business não podem receber chamadas de 1:1 de usuários dos Serviços de Comunicação.
• O escalonamento para uma chamada de grupo não tem suporte.
• A gravação de chamadas dos Serviços de Comunicação não está disponível para chamadas 1:1.
• Não há suporte para recursos avançados de roteamento de chamadas, como encaminhamento de chamadas, recebimento de chamadas em grupo, toque simultâneo e caixa postal.
• Os usuários do Teams não podem definir os usuários dos Serviços de Comunicação como destinos de encaminhamento/transferência.
• Muitos recursos no cliente do Teams não funcionam conforme o esperado durante chamadas entre dois usuários dos Serviços de Comunicação.
• Não há suporte para dispositivos de terceiros para o Teams e telefones IP do Skype.

Privacidade

A interoperabilidade entre os Serviços de Comunicação do Azure e o Microsoft Teams permite que seus aplicativos e usuários participem de chamadas e reuniões do Teams. Você é responsável por garantir que os usuários do aplicativo sejam notificados quando a gravação ou a transcrição estiver habilitada em uma chamada ou reunião do Teams.

A Microsoft indicará por meio da API dos Serviços de Comunicação do Azure que a gravação ou transcrição foi iniciada. Você deve comunicar esse fato em tempo real aos usuários dentro da interface do usuário do aplicativo. Você concorda em indenizar a Microsoft por todos os custos e danos incorridos caso você não cumpra essa obrigação.