Ingressar em uma reunião do Teams

  • Artigo

Os Serviços de Comunicação do Azure podem ser usados para criar aplicativos que permitem aos usuários ingressar e participar em reuniões no Teams. O Preço dos Serviços de Comunicação do Azure Standard se aplica a esses usuários, mas não há nenhum valor adicional para o recurso de interoperabilidade em si. Com o modelo BYOI (traga sua própria identidade), você controla a autenticação do usuário, e os usuários de seus aplicativos não precisam de licenças do Teams para ingressar em reuniões no Teams. Isso é ideal para aplicativos que habilitam usuários do Teams licenciados e usuários externos que usam um aplicativo personalizado para ingressar em uma experiência de consultoria virtual. Por exemplo, provedores de serviços de saúde usando o Teams podem realizar consultas virtuais de saúde com os respectivos pacientes que usam um aplicativo personalizado.

Também é possível usar identidades do Teams com os SDKs dos Serviços de Comunicação do Azure. Mais informações estão disponíveis aqui.

A interoperabilidade não está habilitada para Teams para uso pessoal.

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.

Habilitar o ingresso em reunião anônima em seu locatário do Teams

Quando um usuário BYOI ingressa em uma reunião do Teams, ele é tratado como um usuário externo anônimo, semelhante aos usuários que ingressam em uma reunião Teams anonimamente usando o aplicativo Web do Teams. A capacidade de os usuários BYOI ingressarem em reuniões do Teams como usuários anônimos é controlada pelas mesmas configurações do Teams que controlam a participação anônima em reuniões por meio do aplicativo Web do Teams e está habilitada por padrão. O artigo Gerenciar as configurações de reunião no Microsoft Teams descreve essas configurações.

Aplicativos personalizados criados com Serviços de Comunicação do Azure para se conectar e comunicar com usuários do Teams podem ser usados por usuários finais ou por bots, e não há nenhuma diferenciação de como eles aparecem para usuários do Teams, a menos que o desenvolvedor do aplicativo indique explicitamente isso como parte da comunicação. Seu aplicativo personalizado deve considerar a autenticação do usuário e outras medidas de segurança para proteger as reuniões do Teams. Lembre-se das implicações de segurança de permitir que usuários anônimos participem das reuniões e use o guia de segurança do Teams para configurar as funcionalidades disponíveis para usuários anônimos.

Experiência da reunião

Assim como ocorre com o ingresso anônimo nas reuniões do Teams, seu aplicativo precisa do link de reunião para ingressar. Esse link pode ser recuperado na API do Graph ou no calendário do Microsoft Teams. O nome dos usuários BYOI que é exibido no Teams é configurável por meio dos Serviços de Comunicação que chamam o SDK. Eles são rotulados como "externos" para permitir que os usuários do Teams saibam que não foram autenticados usando o Microsoft Entra ID.

Um usuário dos Serviços de Comunicação não será aceito em uma reunião do Teams até que haja pelo menos um usuário do Teams presente na reunião. Quando um usuário do Teams estiver presente, o usuário dos Serviços de Comunicação aguardará no lobby até que seja aceito explicitamente por um usuário do Teams, a menos que a política/configuração da reunião "Quem pode ignorar o lobby?" esteja definida como "Todos".

Durante uma reunião, os usuários dos Serviços de Comunicação poderão usar as principais funcionalidades de áudio, vídeo, compartilhamento de tela e chat por meio dos SDKs dos Serviços de Comunicação do Azure. Depois que um usuário dos Serviços de Comunicação sair da reunião, ou após a reunião terminar, ele não poderá mais enviar ou receber novas mensagens de chat, e não terá mais acesso às mensagens enviadas e recebidas durante a reunião. Os usuários anônimos dos Serviços de Comunicação não podem adicionar/remover participantes adicionais à/da reunião, nem podem iniciar a gravação nem a transcrição da reunião.

Informações adicionais sobre fluxos de dados necessários para ingressar nas reuniões do Teams estão disponíveis na página de arquitetura do cliente e do servidor. O Exemplo de Destaque de Chamada de Grupo fornece um código de exemplo para ingressar em uma reunião do Teams a partir de um aplicativo Web.

Armazenamento de chat

Durante uma reunião do Teams, todas as mensagens de chat enviadas pelos usuários do Teams ou dos Serviços de Comunicação são armazenadas na região geográfica associada à organização do Microsoft 365 que hospeda a reunião. Para saber mais, confira o artigo Local dos dados no Microsoft Teams. Para cada usuário dos Serviços de Comunicação nas reuniões, há também uma cópia da mensagem enviada mais recentemente armazenada na região geográfica associada ao recurso dos Serviços de Comunicação usado para desenvolver o aplicativo dos Serviços de Comunicação. Para saber mais, confira o artigo Disponibilidade de região e residência de dados.

Se a organização do Microsoft 365 que hospeda a reunião tiver definido uma política de retenção que exclui mensagens de chat de qualquer um dos usuários do Teams na reunião, todas as cópias da mensagem enviada mais recentemente que foram armazenadas para os usuários dos Serviços de Comunicação também serão excluídas de acordo com o política. Se não houver uma política de retenção definida, as cópias da mensagem enviada mais recentemente para todos os usuários dos Serviços de Comunicação serão excluídas após 30 dias. Para saber mais sobre as políticas de retenção do Teams, confira o artigo Saiba mais sobre a retenção do Microsoft Teams.

Diagnóstico e análise de chamada

Após o término da reunião do Teams, as informações de diagnóstico sobre a reunião estarão disponíveis usando o Registro em Log e Diagnóstico dos Serviços de Comunicação e usando a Análise de Chamadas do Teams no centro de administração do Teams. Os usuários dos Serviços de Comunicação aparecerão como "Anônimos" nas telas da Análise de Chamada. Os usuários dos Serviços de Comunicação não estão incluídos na Análise em Tempo Real 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.

Limitações e problemas conhecidos

  • Os usuários de Serviços de Comunicação podem ingressar em uma reunião do Teams agendada para um canal do Teams e usar áudio e vídeo, mas não podem enviar nem receber mensagens de chat, pois eles não são membros do canal.
  • Os usuários dos Serviços de Comunicação podem participar de uma reunião do Teams e usar o vídeo, mas não poderão aplicar efeitos em segundo plano.
  • Os usuários dos Serviços de Comunicação podem ingressar em um webinar do Teams, mas as funções de apresentador e participante não são impostas no momento, portanto, os usuários dos Serviços de Comunicação podem executar ações não destinadas a participantes, como compartilhamento de tela, ativação/desativação da câmera ou ativação do próprio microfone, se o seu aplicativo fornece a experiência do usuário para essas ações.
  • No momento, ao usar o Microsoft Graph para listar os participantes em uma reunião do Teams, os detalhes dos usuários dos Serviços de Comunicação não são incluídos.
  • As apresentações do PowerPoint não são renderizadas para usuários dos Serviços de Comunicação.
  • As reuniões do Teams dão suporte a até 1000 participantes, mas o SDK de chamada dos Serviços de Comunicação do Azure atualmente dá suporte a 350 participantes e o SDK do Chat dá suporte a 250 participantes.
  • Com a Interoperabilidade de Vídeo na Nuvem para Microsoft Teams, alguns dispositivos têm problemas quando um usuário dos Serviços de Comunicação compartilha sua tela.
  • Os eventos de chamada de voz e vídeo dos Serviços de Comunicação não são gerados para reuniões do Teams.
  • Recursos como reações, mão levantada, modo em conjunto e salas de descanso só estão disponíveis para usuários do Teams.
  • Os usuários dos Serviços de Comunicação não podem interagir com aplicativos de pesquisa ou perguntas e respostas em reuniões.
  • Os serviços de comunicação não terão acesso a todos os recursos de chat com suporte pelo Teams. Eles podem enviar e receber mensagens de texto, usar indicadores de digitação, recibos de leitura e outros recursos com suporte no SDK de Chat. No entanto, recursos como compartilhamento de arquivos, resposta ou reação a uma mensagem não têm suporte para usuários dos Serviços de Comunicação.
  • Atualmente, o SDK de Chamada não dá suporte a legendas para reuniões do Teams.
  • Os usuários dos Serviços de Comunicação não podem ingressar em eventos ao vivo do Teams.
  • Eventos do manipulador de atividades do Teams para bots não são acionados quando os usuários de Serviços de Comunicação ingressam em uma reunião do Teams.

Próximas etapas