Interoperabilidade do Teams
Os Serviços de Comunicação do Azure podem ser usados para criar aplicativos personalizados e experiências que permitem a interação com usuários do Microsoft Teams por voz, vídeo, chat e compartilhamento de tela. A Biblioteca de Interface do Usuário dos Serviços de Comunicação fornece componentes de interface do usuário personalizáveis e prontos para produção que podem ser facilmente adicionados a esses aplicativos. O vídeo a seguir demonstra algumas das funcionalidades de interoperabilidade do Teams:
Observação
Compartilhe seus pensamentos e comentários sobre os Serviços de Comunicação do Azure conosco fazendo esta breve pesquisa.
Modelos de identidade do usuário
Os Serviços de Comunicação do Azure dão suporte a dois tipos de interoperabilidade do Teams dependendo da identidade do usuário:
- Usuário externo. Você controla a autenticação do usuário, e os usuários de seus aplicativos personalizados não precisam ter identidades do Microsoft Entra ou licenças do Teams. Esse modelo permite que você crie aplicativos personalizados para que usuários não do Teams se conectem e se comuniquem com usuários do Teams.
- Usuário do Teams. O Microsoft Entra ID controla a autenticação do usuário, e os usuários do seu aplicativo personalizado devem ter licenças do Teams. Esse modelo permite que você compile aplicativos personalizados para os usuários do Teams habilitarem fluxos de trabalho ou experiências especializados que não são possíveis com os clientes Teams existentes.
Os aplicativos podem implementar ambos os modelos de autenticação e deixar a opção de autenticação até o usuário. A tabela a seguir compara dois modelos:
| Recurso | Usuário externo | Usuário do Teams |
|---|---|---|
| Base de usuários de destino | Clientes | Empresa |
| Provedor de identidade | Qualquer | Microsoft Entra ID |
| Nome de exibição | Qualquer um com o sufixo "(Externo)" | Valor do usuário do Microsoft Entra da propriedade "Nome para exibição" |
| Autenticação e autorização | Personalizado* | Microsoft Entra ID e personalizado* |
| Chamada disponível via | SDKs de chamadas dos Serviços de Comunicação | SDKs de chamadas dos Serviços de Comunicação |
| O chat está disponível por meio de | SDKs de chat dos Serviços de Comunicação | API do Graph |
| Ingressar em reuniões do Teams | Sim | Yes |
| Fazer e receber chamadas como usuários do Teams | Não | Sim |
| Suporte a PSTN | Não há suporte para usuários dos Serviços de Comunicação em reuniões do Teams | Telefone do Microsoft Teams, plano de chamadas, roteamento direto, conexão do operador |
* A lógica do servidor que emite tokens de acesso pode executar qualquer autenticação e autorização personalizadas da solicitação.
Usuário externo
O modelo de autenticação BYOI (traga sua própria identidade) permite que você compile aplicativos personalizados para que usuários externos se conectem e se comuniquem com usuários do Teams. Você controla a autenticação do usuário, e os usuários de seus aplicativos personalizados não precisam ter identidades do Microsoft Entra ou licenças do Teams. O primeiro cenário habilitado permite que os usuários do aplicativo participem de reuniões do Microsoft Teams como contas externas, semelhantes a usuários anônimos que ingressam em reuniões usando o aplicativo Web do Teams. Esse recurso é ideal para aplicativos entre empresa e consumidor que combinam funcionários (familiarizados com o Teams) e usuários externos (usando um aplicativo personalizado) em uma experiência de reunião. No futuro, habilitaremos cenários adicionais, como chamadas diretas e chat, que permitirão ao seu aplicativo iniciar chamadas e chats com usuários do Teams fora do contexto de uma reunião do Teams.
Para obter mais informações, confira Participar de uma reunião do Teams.
No momento, não é possível que um usuário do Teams ingressar em uma chamada iniciada por meio do SDK de Chamada dos Serviços de Comunicação do Azure.
Usuário do Teams
Os desenvolvedores podem usar o Communication Services Calling SDK com identidade do Teams para criar aplicativos personalizados para usuários do Teams. Os aplicativos personalizados podem habilitar fluxos de trabalho especializados para usuários do Teams, como gerenciar chamadas telefônicas de entrada e saída ou trazer a experiência de chamada do Teams para dispositivos que não têm suporte com o cliente padrão do Teams. O Microsoft Entra autentica os usuários do Teams, e todos os atributos e detalhes sobre o usuário são vinculados à conta do Microsoft Entra.
Quando um ponto de extremidade dos Serviços de Comunicação se conecta a uma reunião ou chamada do Teams usando uma identidade do Teams, o ponto de extremidade é tratado como um usuário do Teams com um cliente do Teams. A experiência é impulsionada por políticas atribuídas aos usuários dentro e fora da organização. Os usuários do Teams podem ingressar em reuniões do Teams, fazer chamadas para outros usuários do Teams, receber chamadas de números de telefone e transferir chamadas em andamento para a fila de chamadas do Teams ou compartilhar tela.
Os usuários do Teams se autenticam na ID do Microsoft Entra no aplicativo cliente. Em seguida, os desenvolvedores trocam tokens de autenticação do Microsoft Entra ID por tokens de acesso por meio do SDK de Identidade do Communication Services. Essa troca cria uma conexão entre o Microsoft Entra ID e os Serviços de Comunicação. Você é incentivado a implementar uma troca de tokens em seus serviços de back-end, pois as credenciais para os Serviços de Comunicação do Azure assinam solicitações de troca. Em seus serviços de back-end, você pode exigir qualquer autenticação adicional.
Experiências de reuniões e chamadas do Teams
Há várias maneiras de os usuários ingressarem em uma reunião do Teams:
- Por meio de clientes do Teams como usuários do Teams. Isso inclui os clientes do Teams no desktop, em dispositivos móveis e na Web.
- Por meio de clientes do Teams como usuários anônimos não autenticados.
- Por meio de aplicativos personalizados dos Serviços de Comunicação como Usuários externos usando o modelo de autenticação traga a própria identidade.
- Por meio de aplicativos personalizados dos Serviços de Comunicação como usuários do Teams usando o modelo de autenticação do Teams.
Usando o modelo de autenticação de identidade do Teams, um aplicativo de Serviços de Comunicação permite que os usuários do Teams participem de chamadas com outros usuários do Teams que estejam usando os clientes do Teams:
Privacidade
A interoperabilidade entre os Serviços de Comunicação do Azure e o Microsoft Teams permite que os aplicativos e usuários participem de chamadas, reuniões e chats 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 informará você por meio da API dos Serviços de Comunicação do Azure que a gravação ou transcrição foi iniciada e você deve comunicar esse fato em tempo real aos usuários na 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.
Preços
Todo uso de APIs e SDKs do Serviço de Comunicação do Azure incrementa os medidores de cobrança do Serviço de Comunicação do Azure. As interações com o Microsoft Teams, como ingressar em uma reunião ou iniciar uma chamada telefônica usando um número alocado pelo Teams, incrementarão esses medidores. No entanto, não há valores adicionais para a capacidade de interoperabilidade em si do Teams, nem distinção de preço entre as opções de autenticação BYOI e Microsoft 365.
Se um usuário do aplicativo do Azure gastar 10 minutos em uma reunião com um usuário do Microsoft Teams, ambos os usuários consumiram, em conjunto, 20 minutos de chamada. Os 10 minutos exercitados por meio do aplicativo personalizado e do uso de APIs e SDKs do Azure serão cobrados em seu recurso. No entanto, os 10 minutos consumidos pelo usuário no aplicativo nativo do Teams são cobertos pela licença de aplicável do Teams e não são monitorados pelo Azure.
Marca e diretriz de marca
Terceiros devem seguir as Diretrizes de Marcas e Marcas Comerciais da Microsoft ao usar marcas comerciais ou logotipos de produtos do Microsoft Teams em materiais publicitários ou promocionais. Em geral, as marcas de texto podem ser usadas para transmitir informações verdadeiras sobre seu produto ou serviço, desde que os clientes e o público não se confundam em acreditar que a Microsoft é afiliada ou endossa seu produto ou serviço. No entanto, nossos logotipos, aplicativos, ícones de produtos, ilustrações, fotografias, vídeos e designs nunca podem ser usados sem uma licença expressa. Para obter mais detalhes sobre identidade visual, leia Diretrizes de marca registrada e marca da Microsoft.
Teams em Nuvens Governamentais (GCC)
No momento, a interoperabilidade com os Serviços de Comunicação do Azure não é compatível com as implantações do Teams usando as nuvens governamentais (GCC) do Microsoft 365.
Próximas etapas
Encontre mais detalhes sobre a interoperabilidade do usuário externo:
- Obter tokens de acesso para usuário externo
- Ingressar na chamada de reunião do Teams como um usuário externo
- Ingressar no chat de reunião do Teams como um usuário externo
Encontre mais detalhes sobre a interoperabilidade do usuário do Teams: