Comunicação como usuário do Microsoft 365
Você pode usar os Serviços de Comunicação do Azure e a API do Graph para integrar a comunicação como usuários do Microsoft 365 em seus produtos. Os usuários do Microsoft 365 podem se comunicar com outras pessoas dentro e fora de sua organização. Os benefícios para as empresas são:
- Não é necessário baixar o desktop, o celular ou os clientes Web do Teams para usuários do Teams
- Os usuários do Teams não perdem o contexto alternando entre aplicativos para o trabalho diário e o cliente do Teams para comunicação
- O Teams é uma única origem para mensagens de chat e histórico de chamadas dentro da organização
- As políticas do Teams controlam a comunicação entre aplicativos
Os benefícios do uso da superfície de API para desenvolvedores são:
- Suporte ao navegador em dispositivos móveis
- Personalização da IU (interface do usuário)
- Nenhuma licença adicional do Teams é necessária
- Locatários trazem políticas e configurações dentro de seu aplicativo sem trabalho extra
Você também pode usar API do Graph para implementar recursos de chat e chamada no lado do servidor. Este artigo se concentra na experiência do cliente.
Casos de uso
Aqui estão exemplos reais de aplicativos:
- O ISV (fornecedor independente de software) compila um aplicativo Web de atendimento ao cliente para recepcionistas encaminharem chamadas em uma organização. Recepcionistas em várias organizações usam esse produto sob medida para suas necessidades para encaminhar chamadas para especialistas no assunto (SMEs) dentro da organização.
- O fabricante do headset de realidade aumentada adiciona a capacidade de chamada de vídeo ao produto para habilitar a assistência remota com especialistas no assunto que ingressaram por meio de clientes do Teams. O usuário do Teams vê uma chamada de entrada de um trabalhador de linha de frente que compartilha a realidade aumentada e fornece diretrizes diretamente do cliente do Teams.
- O ISV (fornecedor independente de software) compila um aplicativo para divulgação do cliente por meio de vários canais. O ISV adiciona recursos de chat e chamada do Teams ao produto para habilitar a comunicação com usuários corporativos diretamente de seu aplicativo.
- O banco decidiu substituir seu aplicativo limitado do Teams para gerenciamento de riqueza por meio da integração direta da chamada como usuário do Teams com seu aplicativo de gerenciamento de riqueza existente. Agora esse aplicativo integra a capacidade de chamada como parte do processo em vez de incorporar processos dentro do cliente do Teams.
Criação de protótipo
Os desenvolvedores podem experimentar os recursos em vários níveis para avaliar, aprender e personalizar o produto. No momento, as opções de baixo/sem código estão em desenvolvimento.
Implantação de clique único
O exemplo de herói de autenticação dos Serviços de Comunicação do Azure demonstra como os desenvolvedores podem usar o SDK de Identidade dos Serviços de Comunicação do Azure para obter tokens de acesso como usuários do Teams. Você pode clonar o repositório GitHub e seguir um guia simples para configurar seu serviço para autenticação no Azure.
No momento, a amostra do herói de chamada e chat para usuários do Teams está em desenvolvimento.
Codificação
Comunicação como usuário do Teams aproveita API do Graph para chat e Serviços de Comunicação do Azure para chamadas. Em cada caso, você precisa autenticar o usuário do Teams e, em seguida, implementar a lógica de comunicação.
Os diagramas nas próximas seções demonstram casos de uso multilocatário, em que a empresa fictícia Fabrikam é o cliente da empresa fictícia Contoso. A Contoso cria um produto SaaS multilocatário que o administrador da Fabrikam adquire para seus funcionários.
Chamando
Os recursos de voz, vídeo e compartilhamento de tela são fornecidos por meio dos Serviços de Comunicação do Azure dos SDKs de chamada. O diagrama a seguir mostra uma visão geral do processo que você seguirá para integrar suas experiências de chamada às identidades do Teams compatíveis com os Serviços de Comunicação do Azure.
Você pode usar o SDK de Identidade dos Serviços de Comunicação do Azure para trocar tokens de acesso do Microsoft Entra de usuários do Teams para tokens de acesso à Identidade de Comunicação.
Os seguintes artigos orientarão você na implementação da comunicação para usuários do Teams:
- Autenticar como usuário do Teams
- Adicionar chamada de vídeo como usuário do Teams ao aplicativo cliente
- Como usar o SDK de chamada como usuário do Teams
Chat
Use API do Graph para integrar chat 1:1, chat em grupo, chat de reunião e recursos de canal ao seu produto.
Os seguintes artigos orientarão você na implementação do chato para usuários do Teams:
- Autenticar como usuário do Teams
- Enviar mensagem como usuário do Teams
- Receba uma mensagem como usuário do Teams no webhook e envie uma mensagem por push para o cliente, por exemplo, usando SignalR.
- Mensagens de sondagem para o usuário do Teams
Casos de uso compatíveis
A seguinte tabela mostra casos de uso com suporte para usuários do Teams com os Serviços de Comunicação do Azure e API do Graph:
| Cenário | Com suporte |
|---|---|
| Fazer uma VoIP (chamada de voz por IP) para o usuário do Teams | ✔️ |
| Fazer uma chamada por telefone (PSTN) | ✔️ |
| Aceitar chamada VoIP (chamada de voz por IP) de entrada para usuário do Teams | ✔️ |
| Aceitar chamada por telefone de entrada (PSTN) para usuário do Teams | ✔️ |
| Participar da Reunião do Teams | ✔️ |
| Ingressar na reunião do Teams do canal | ✔️ |
| Ingressar no webinar do Teams [1] | ✔️ |
| Participe de eventos ao vivo do Teams. | ❌ |
| Ingressar na reunião do Teams agendada no aplicativo para uso pessoal | ❌ |
| Ingressar no Teams 1:1 ou chamada em grupo | ❌ |
| Enviar uma mensagem para chat 1:1, chat em grupo ou chat de reunião do Teams | ✔️ |
| Enviar mensagens do chat 1:1, chat em grupo ou chat de reunião do Teams | ✔️ |
- [1] Os usuários do Teams podem ingressar em um webinar do Teams. No entanto, as funções de apresentador e participante não são respeitadas para os usuários do Teams. Assim, os convidados do Teams nos SDKs dos Serviços de Comunicação do Azure podem executar ações não destinadas a participantes, como compartilhamento de tela, ativação e desativação da câmera ou ativação do próprio microfone, se o aplicativo fornecer experiência de usuário para essas ações.
Preços
Os usuários do Teams podem ingressar na experiência de reunião do Teams, gerenciar chamadas e gerenciar chats por meio do desktop, celular e clientes Web existentes do Teams ou API do Graph sem custo adicional. Os usuários do Teams utilizando SDKs de Serviços de Comunicação do Azure pagarão o consumo padrão de Serviços de Comunicação do Azure para áudio e vídeo. Não há nenhuma valor adicional para a capacidade de interoperabilidade em si. Você pode encontrar mais detalhes sobre os preços de interoperabilidade do Teams aqui.
Próximas etapas
Encontre mais detalhes nos seguintes artigos: