Interoperabilidade do Teams: Chamando
Importante
A funcionalidade descrita neste artigo está atualmente em visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
Como parte dessa visualização, os SDKs dos Serviços de Comunicação do Azure podem ser usados para criar aplicativos que permitem que os usuários tragam sua própria identidade (BYOI) para iniciar chamadas 1:1 com usuários do Teams. O preço padrão dos Serviços de Comunicação do Azure se aplica a esses usuários, mas não há nenhuma taxa extra para o recurso de interoperabilidade. Os 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á diferenciação na forma como eles aparecem para os usuários do Teams em aplicativos do Teams, a menos que explicitamente indicado pelo desenvolvedor do aplicativo com um nome para exibição.
Para habilitar a chamada entre os usuários dos Serviços de Comunicação e o locatário do Teams, permita que 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.
Habilite a interoperabilidade em seu locatário do Teams
O usuário do Microsoft Entra com a 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 Microsoft Teams
Primeiro, abra o PowerShell e valide a existência do módulo Teams com o seguinte comando:
Get-module *teams*
Se não vir o módulo, instale-o MicrosoftTeams 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, o que você pode confirmar com uma Y ou A resposta. Se o módulo estiver instalado, mas estiver desatualizado, você poderá executar o seguinte comando para atualizá-lo:
Update-Module MicrosoftTeams
2. Conecte-se ao módulo Microsoft Teams
Quando o módulo estiver instalado e pronto, você poderá se conectar ao módulo MicrosoftTeams com o seguinte comando. Ser-lhe-á solicitada uma janela interativa para iniciar sessão. A conta de usuário que você vai usar precisa ter permissões de administrador do Teams. Caso contrário, você poderá obter uma access denied resposta nas próximas etapas.
Connect-MicrosoftTeams
3. Habilitar a configuração do locatário
A interoperabilidade com os 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 configuração de locatário único e os usuários do Teams atribuíram política global ou política personalizada. Para obter mais informações, consulte Atribuir políticas no Teams.
Após o logon bem-sucedido, você pode executar o cmdlet Set-CsTeamsAcsFederationConfiguration para habilitar o recurso Serviços de Comunicação em seu locatário. Substitua o texto IMMUTABLE_RESOURCE_ID por um 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. Ativar a política de inquilino
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 sido definida EnableAcsFederationAccess como $true
Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true
Obter ID de utilizador do Teams
Para iniciar uma chamada com um usuário do Teams ou aplicativo do Teams Voice, você precisa de um identificador do destino. Você tem as seguintes opções para recuperar o ID:
- Interface de usuário do Microsoft Entra ID ou com sincronização de diretório local Microsoft Entra Connect
- Programaticamente via API do Microsoft Graph
Telefonar
Com o SDK de chamada, um usuário ou ponto de extremidade dos Serviços de Comunicação pode iniciar uma chamada 1:1 com usuários do Teams, identificados por sua 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.
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 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 chamadas 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.
Problemas conhecidos e de limitações
- Essa funcionalidade não está disponível no momento 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 1:1 de usuários dos Serviços de Comunicação.
- Não há suporte para escalonamento para uma chamada em grupo.
- A gravação de chamadas dos Serviços de Comunicação não está disponível para chamadas 1:1.
- Recursos avançados de roteamento de chamadas, como encaminhamento de chamadas, recebimento de chamadas em grupo, toque simultâneo e caixa postal, não são suportados.
- 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 como esperado durante chamadas 1:1 com usuários dos Serviços de Comunicação.
- Não há suporte para dispositivos de terceiros para telefones IP do Teams e 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. É da responsabilidade do Cliente assegurar que os utilizadores da sua aplicação são notificados quando a gravação ou a transcrição é ativada numa chamada ou reunião do Teams.
A Microsoft indicará através 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 seus usuários dentro da interface do usuário do seu aplicativo. Você concorda em indenizar a Microsoft por todos os custos e danos incorridos devido ao não cumprimento desta obrigação.