Bot do Teams com chamada e reunião - Teams

O bot de chamada e reunião do Microsoft Teams fornece funcionalidades básicas, como, criar uma chamada, ingressar em uma chamada, transferir ou redirecionar uma chamada, ingressar em uma reunião agendada e convidar os participantes integrando comunicações de nuvem API do Graph.

Os bots podem interagir com chamadas e reuniões do Teams usando voz, vídeo e compartilhamento de tela em tempo real. Com APIs do Microsoft Graph para chamadas e reuniões online, os aplicativos do Teams podem interagir com usuários usando voz e vídeo para aprimorar sua experiência. Essas APIs permitem que você adicione os seguintes novos recursos:

Use o IVR (Interactive Voice Response).
Use o controle de chamada.
Forneça acesso a fluxos de áudio e vídeo em tempo real, incluindo compartilhamento de área de trabalho e aplicativo.

Crie um bot e especifique informações e permissões adicionais para usar essas APIs do Graph em um aplicativo do Teams.

Este guia passo a passo ajuda você a configurar o bot de chamada e reunião do Teams. Ao final deste tutorial, você pode obter a seguinte saída:

Saída final.

Pré-requisitos

10 minutos restantes

Certifique-se de instalar as seguintes ferramentas e configurar seu ambiente de desenvolvimento:

	Instalar	Para usar...
Required
	Conta de desenvolvedor do Microsoft 365	Acesso à conta do Teams com as permissões apropriadas para instalar um aplicativo.
	ngrok	Os recursos do aplicativo Teams (bots de conversa, extensões de mensagem e webhooks de entrada) exigem conexões de entrada. Um túnel conecta seu sistema de desenvolvimento ao Teams. Não é necessário para aplicativos que incluem apenas guias. Esse pacote é instalado no diretório do projeto (usando npm `devDependencies`).
	Visual Studio 2022 versão 17.3 Instale uma das duas cargas de trabalho a seguir: • ASP.NET e desenvolvimento web • Desenvolvimento entre plataformas do .NET Core	Você pode instalar a versão corporativa no Visual Studio 2022 e instalar as cargas de trabalho.
	SDK do .NET Core versão 3.1 (não uma conta de convidado)	Associações personalizadas para implantações de aplicativo de depuração local e Azure Functions. Se você ainda não instalou o SDK do .NET 3.1 (ou posterior) globalmente, a versão portátil poderá ser instalada.
	Microsoft Teams e uma conta do Teams	Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chats, reuniões, chamadas e tudo em um só lugar.
	Windows PowerShell	Instale executando todos os comandos.

Configurar o bot de chamada e reunião

9 minutos restantes

Registre um aplicativo usando o registro de aplicativo no Microsoft portal do Azure para que seu aplicativo se integre ao plataforma de identidade da Microsoft e chame a Microsoft API do Graph. Execute as etapas a seguir:

Crie um túnel ngrok para os pontos de extremidade do servidor Web.
Crie o recurso de bot do Azure para registrar bot com o serviço de bot do Azure.
Crie o segredo do cliente que habilita a autenticação de SSO (logon único) do bot.
Crie uma política para um usuário locatário de demonstração para criar reuniões online usando o PowerShell.
Adicione permissões de API para chamadas downstream.
Criar registro de canal de bot na conta do Azure.
Adicione o canal do Microsoft Teams para implantar o bot em um canal do Teams.
Adicione o ponto de extremidade de mensagens ao túnel ngrok que você criou.

Criar túnel ngrok

Use o ngrok para criar um túnel para os pontos de extremidade HTTPS disponíveis publicamente do servidor Web localmente. Execute o seguinte comando no ngrok:

ngrok http --host-header=rewrite 3978

Registrar um aplicativo no Azure

Vá para portal do Azure usando sua conta microsoft pessoal.
Selecione Azure Active Directory.
No painel esquerdo, selecione Registros de aplicativo.
Selecione Novo registro.

O registro de uma janela de aplicativo é exibido. Insira as informações de registro do aplicativo.

Em Nome, insira o nome do aplicativo exibido aos usuários.
Em Tipos de conta com suporte, selecione as contas que você deseja que seu aplicativo dê suporte.
No URI de Redirecionamento (opcional), selecione o tipo de aplicativo Web ou Cliente Público (móvel e desktop) e insira o URI de redirecionamento para seu aplicativo.

Observação

Para aplicativos Web, forneça o URI base como http://localhost:31544. Para aplicativos cliente públicos, forneça o URI usado por Azure AD para retornar respostas de token como myapp://auth.
Selecione Registrar.

Para criar o segredo do cliente

Na página Visão geral do bot, selecione Essentials e salve a ID do Aplicativo (cliente) (ID do Aplicativo Microsoft) para referência futura.
Em Gerenciar, selecione Certificados & segredos.
Selecione Segredos > do cliente Novo segredo do cliente.

A janela adicionar um segredo do cliente é exibida.

Insira Descrição para o segredo do cliente.
Selecione Adicionar.
Selecione Copiar para área de transferência para copiar os detalhes do Valor .

Dica

Salve os segredos do cliente Valor ou senha do aplicativo para referência futura.

Executar script do PowerShell para criar uma política

Crie uma política para um usuário locatário de demonstração criar reuniões online usando o seguinte script do PowerShell:

Observação

Execute Windows PowerShell PSI como administrador e execute o script.


New-CsApplicationAccessPolicy -Identity "<<policy-identity/policy-name>>" -AppIds "<<azure-client-id>>" -Description "Policy-description"
Grant-CsApplicationAccessPolicy -PolicyName "<<policy-identity/policy-name>>" -Identity "<<object-id-of-the-user-to-whom-policy-need-to-be-granted>>"

Substitua azure-client-id pela ID do Aplicativo Microsoft e object-id pela ID do Locatário da sua conta usada para entrar no Teams. Copie o link conforme mostrado na imagem a seguir e você pode encontrar a ID do locatário da sua conta do Teams no link obtido:
1. Selecione Teams.
2. Selecione a reticência ●●●.
3. Selecione Obter um link para a equipe.
Adicione PolicyName, azure-client-id, policy-descriptione object-id no script do PowerShell.
Entre com sua conta do Teams quando o PowerShell solicitar.
Execute o comando a seguir no PowerShell para verificar se a política foi criada com êxito ou não. Substitua o nome da política pelo nome da política definido.
```
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
```
Observação

Verifique se os scripts em execução não estão desabilitados em seu sistema. Para obter mais informações, consulte políticas de execução.

Para adicionar permissões de API para chamadas downstream

Observação

Verifique se sua conta pode conceder o consentimento do administrador para a Microsoft. Depois de adicionar permissões, selecione Grant admin consent for Microsoft para saber o status do consentimento.

No painel Gerenciar do bot, selecione permissões de API.
Selecione Adicionar uma permissão. A janela Solicitar permissões de API é exibida.
Selecione APIs da > Microsoft Microsoft Graph.
Selecione Permissões de aplicativos.
Selecione permissões e adicione as seguintes permissões de aplicativos API do Graph ao seu Azure App e conceda o consentimento do administrador:
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.InitiateGroupCall.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
- OnlineMeetings.ReadWrite.All
Selecione Adicionar permissões.

Criar registro de canal de bot na conta do Azure

Acesse o Portal do Azure.
Selecione Criar um recurso.
Pesquise o Bot do Azure na caixa de pesquisa.
Selecione Bot do Azure.
Selecionar Criar.

Criar uma janela do Bot do Azure é exibida.
Digite o nome do identificador do bot no campo Identificador do bot.
Selecione sua Assinatura e grupo de recursos na lista suspensa.

Você também pode criar um novo grupo de recursos. Selecione Criar nova > inserir o nome do recurso > selecione OK.
Selecione o local necessário na lista suspensa Local do novo grupo de recursos , se você tiver criado um novo grupo de recursos.
Selecione Tipo de Aplicativo como Vários Locatários.

Observação

Na Creation type seção ID do Aplicativo da Microsoft, Create new Microsoft App ID já está selecionado para criar um novo bot. Você também pode selecionar Use existing app registration, se você já registrou um bot. Insira a ID do Aplicativo Microsoft no Existing app ID campo e insira valor no Existing app password campo.
Selecione Usar o registro de aplicativo existente e insira a ID do aplicativo do Azure registrada no locatário de demonstração.
Selecione Rever + criar.
Se a validação for aprovada, selecione Criar.

Levará alguns minutos para o serviço de bot ser provisionado.
Selecione Vá para o recurso. O bot e os respectivos recursos estão listados no grupo de recursos.

Agora, o bot do Azure foi criado.

Para adicionar o canal do Microsoft Teams

Vá para a Página Inicial.
Selecione seu bot nos recursos recentes.
Selecione Canais no painel esquerdo.
Selecione Microsoft Teams .
Selecione a caixa de seleção para aceitar os Termos de Serviço.
Selecione Concordar.
Selecione Aplicar.
Selecione Microsoft Teams e selecione Guia de chamada na página do canal do Teams.
Selecione Habilitar chamada e atualize o Webhook com sua URL de ngrok HTTPS (https://yourngrok/api/callback) e adicione /api/callback no final.
Selecione Aplicar.

Para adicionar ponto de extremidade de mensagens

Vá para ngrok.
Copie a URL HTTPS (https para io) conforme mostrado na imagem a seguir:
Vá para Página Inicial do bot.
Selecione Configuração em Configurações no painel esquerdo.
No ponto de extremidade de mensagens, adicione a URL HTTPS do ngrok e, no final da URL, adicione /api/messages.
Selecione Aplicar.

Você configurou com êxito um bot no serviço de bot do Azure e precisa configurar a conexão do serviço de bot.

Atualizar e criar pacote de aplicativos do Teams

4 minutos restantes

Configure o exemplo de bot para entender como autenticar o bot de conversa no Microsoft Teams e criar o pacote de aplicativos do Teams e carregá-lo na organização.

Atualizar appsettings.json no Visual Studio.
Atualize manifest.json no Visual Studio e compacte-o para o arquivo zip no Explorador de Arquivos.

Atualizar as configurações de aplicativos para chamar bot

Vá para o repositório https://github.com/OfficeDev/Microsoft-Teams-Samples.git.
Selecione Código e selecione a lista suspensa.
Selecione Baixar ZIP.

Observação

Verifique o caminho do repositório baixado.
No Explorador de Arquivos, acesse a pasta csharp do microsoft-teams-samples-main > samples > bot-calling-meeting > .
Abra o arquivo appsettings.json no Visual Studio e atualize a configuração do bot.
- Você pode obter a MicrosoftAppId na página de configuração do bot. O MicrosoftAppPassword é o valor da ID de segredo do cliente que você salvou anteriormente.
- Você pode obter o tenantId ou UserId do link da conta usada para entrar no Teams. Siga o caminho na imagem para obter o link para tenantId:
  1. Selecione Teams.
  2. Selecione reticências ●●●.
  3. Selecione Obter um link para a equipe.
- Você pode obter o e id do displayName site do Microsoft Graph Explorer:
  - Entre na página usando sua conta de locatário do Teams.
  - Adicione Users no final da URl na caixa de pesquisa.
  - Selecione Executar consulta.
  - Os nomes de exibição e as IDs de usuário vinculados à sua conta são gerados.
  - Escolha as três contas e adicione-as DisplayName ao e UserId em appsettings.json.
  Observação
  
  TenantId ou UserId da conta do Teams denota de onde você deseja iniciar a chamada e DisplayName UserId dos usuários denotam para quem você deseja redirecionar ou transferir a chamada.
Substitua MicrosoftAppId, ClientId, AppId por ID do aplicativo (cliente) e MicrosoftAppPassword, ClientSecrete AppSecret pelo Valor.
Substitua pela BotBaseUrl ngrok URL.
Substitua TenantId e UserId.
Substitua DisplayName e Id.
Selecione Salvar.

Para atualizar manifesto

No Explorador de Arquivos, acesse a pasta Manifesto csharp > do Microsoft-Teams-Samples-main > samples > bot-calling-meeting > .
Abra o arquivo manifest.json no Visual Studio.
No arquivo, substitua {id}, {BotId} pela ID do manifest.json Aplicativo Microsoft.
Adicione url ngrok em validDomains , excluindo https://.
Feche o conteúdo da pasta Manifesto para criar manifest.zip.

Observação

O manifest.zip não deve conter pastas extras nela. Ele deve ter manifest json o arquivo de origem, color o ícone e outline o ícone dentro da pasta zip. Carregue seu manifesto em seu locatário de demonstração para a organização ou sua conta do Teams e execute sua solução no Visual Studio.
Vá para o Teams.
Para carregar manifest.zip, selecione Aplicativos > Gerenciar seus aplicativos > Carregar um aplicativo > Carregar um aplicativo personalizado.
Abra manifest.zip na pasta do repositório no Explorador de Arquivos.
Selecione Adicionar para instalar o bot de chamada no Teams.

Você pode interagir com esse bot após a depuração no Visual Studio.

Interagir com o bot de chamada e reunião

3 minutos restantes

O bot permite que você acesse serviços e conteúdo em um espaço dedicado em um canal ou em um chat.

Execute as seguintes etapas para usar o bot:

No painel esquerdo do Teams, selecione as reticências ●●● e escolha seu aplicativo na lista.
O bot envia um texto de boas-vindas com Cartão Adaptável.
Selecione Criar Chamada.
Selecione Transferir Chamada.
Você pode pedir ao bot para agendar uma reunião e convidar os participantes.

Desafio completo

1 minutos restantes

Você veio com uma saída como esta?