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 de usuário e os usuários de seus aplicativos personalizados não precisam ter identidades 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 de 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 | Sim |
| 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 de usuário e os usuários de seus aplicativos personalizados não precisam ter identidades Microsoft Entra ou licenças do Teams. O primeiro cenário habilita os usuários do aplicativo a participarem 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, planejamos implementar mais cenários, incluindo chamadas diretas e chat para permitir que seu aplicativo inicie 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 estão associados à 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 no Microsoft Entra ID no aplicativo cliente. Os desenvolvedores então trocam os tokens de autenticação do Microsoft Entra ID para tokens de acesso por meio do SDK de Identidade dos Serviços de Comunicação. 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 dos Serviços de Comunicação permite que usuários do Teams ingressem em chamadas com outros usuários do Teams que estão usando 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, incrementam 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 sã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.
Diretrizes de marca
Terceiros devem seguir as Diretrizes de Marca da Microsoft ao usar marcas comerciais ou logotipos de produtos do Microsoft Teams em materiais promocionais ou anúncios. Em geral, as marcas nominativas podem ser usadas para transmitir informações confiáveis sobre seu produto ou serviço, desde que os clientes e o público não sejam confundidos e acreditem que a Microsoft está afiliada ou endossa seu produto ou serviço. No entanto, nossos logotipos, aplicativos, ícones de produto, ilustrações, fotografias, vídeos e designs nunca podem ser usados sem uma licença expressa. Para obter mais detalhes sobre identidade visual, leia as Diretrizes de Marca da Microsoft.
O uso de identidade visual de terceiros do Microsoft Teams só é permitido para parceiros certificados do Teams. Sem uma disposição de licença ou certificação com a Microsoft, tudo em seu aplicativo ou produto (incluindo nome do desenvolvedor, nome do aplicativo, logotipo, descrição, capturas de tela e outras garantias de aplicativo) deve ser exclusivo para (nome da empresa) e livre dos Ativos de Marca da Microsoft. A única exceção é que você pode declarar verdadeiramente se seu aplicativo é compatível ou interoperável com um produto ou serviço da Microsoft dentro da descrição do texto sobre seu aplicativo.
Por exemplo:
"(Nome do aplicativo) da (Nome da Empresa) integrado ao Microsoft Teams"
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: