Bot do Teams com chamada e reunião - Teams

O bot de Chamada e Reunião 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 a API de comunicações na 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 as APIs do Microsoft Graph para chamadas e reuniões online, os aplicativos do Teams agora podem interagir com os usuários usando voz e vídeo para aprimorar a experiência. Essas APIs permitem que você adicione os seguintes novos recursos:

IVR (Resposta interativa de voz).
Controle de chamadas.
Acesso a fluxos de áudio e vídeo em tempo real, incluindo compartilhamento de aplicativos e área de trabalho.

Crie um bot e especifique algumas 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 criar um bot com funcionalidade de chamada e reunião. Ao final deste tutorial, você poderá obter a seguinte saída:

Saída final

Pré-requisitos

10 minutos restantes

Instale as seguintes ferramentas e configure seu ambiente de desenvolvimento:

Office 365 locatário
Solução de túnel Ngrok ou equivalente
Visual Studio 2019
SDK do .NET Core versão 3.1
Microsoft Teams com uma conta (não uma conta de convidado)
Instalar Windows PowerShell 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 o Microsoft Graph. Execute o seguinte:

Use o ngrok para criar um túnel para os pontos de extremidade do servidor Web.
Crie um recurso de Bot do Azure para registrar o bot no Azure Serviço de Bot.
Crie um segredo do cliente que habilite a autenticação de SSO do bot.
Crie uma política para um usuário de locatário de demonstração para criar as reuniões online usando o PowerShell.
Adicione permissões de API para chamadas downstream.
Crie o registro de canal do 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.

Crie um túnel ngrok:

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

ngrok http -host-header=rewrite 3978

Registrar um aplicativo no Azure:

Entre no portal do Azure usando sua conta microsoft pessoal.
Selecione o serviço do Azure Active Directory, selecione Registros de aplicativo no painel esquerdo e, em seguida, selecione Novo registro.
A página Registrar um aplicativo é aberta. Insira as informações de registro do aplicativo.
Insira um nome de aplicativo significativo que é exibido para os usuários do aplicativo.
Em tipos de conta com suporte, selecione as contas às quais você deseja que seu aplicativo seja compatível.
No campo URI de Redirecionamento (opcional), selecione o tipo de cliente Web ou Público do aplicativo (área de trabalho móvel &) 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 pelo Azure AD para retornar respostas de token como myapp://auth.
Selecione Registrar.

Para criar um segredo do cliente:

Na página Visão geral do bot, selecione Essentials e salve a ID do cliente do aplicativo (ID do aplicativo da Microsoft) para referência futura.
Em Gerenciar, selecione Certificados & segredos , selecione Segredos do cliente e selecione Novo segredo do cliente. A janela Adicionar um segredo do cliente é exibida.
Digite uma Descrição e selecione Adicionar.
Na coluna Valor, selecione Copiar para a área de transferência e salve a ID do segredo do cliente para referência futura.

Execute o script do PowerShell para criar uma política:

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

Observação

Execute Windows PowerShell PSI como administrador e execute o script.
azure-client-id Substitua pela ID do aplicativo Da Microsoft do bot object-id e pela ID do Locatário da sua conta usada para fazer logon no Teams (copie o link conforme mostrado na imagem a seguir e você poderá encontrar a ID do locatário da sua conta do Teams no link obtido).
Adicione PolicyName, azure-client-ide policy-descriptionno object-id script do PowerShell. Faça logon 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 definida.
```
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
```

Para adicionar permissões de API para chamadas downstream:

Observação

Certifique-se de que sua conta possa conceder 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 AS APIs da Microsoft e selecione Microsoft Graph.
Selecione permissões de aplicativo e, em seguida, selecione permissões.
Adicione as permissões API do Graph aplicativos a seguir 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.

Crie o registro de canal do Bot na conta do Azure:

Abra portal do Azure.
Selecione Criar um recurso.
Pesquise o Bot do Azure na caixa de pesquisa.
Selecione o Bot do Azure.
Selecionar Criar.
Digite o nome do identificador do bot no campo Identificador do bot.
Selecione sua Assinatura na lista suspensa.
Selecione seu Grupo de recursos na lista suspensa.

Para criar um novo grupo de recursos, selecione Criar, insira o nome do recurso, selecione OK e selecione o local necessário na lista suspensa Novo local do grupo de recursos.
Selecione o Tipo de Aplicativo Multilocatário para a ID de Aplicativo da Microsoft.

Observação

Na Creation type seção ID do Aplicativo da Microsoft, já Create new Microsoft App ID está selecionado para criar um bot. Você também pode selecionar Use existing app registration, se já tiver registrado um bot. Insira a ID do Aplicativo da Existing app id Microsoft no campo e insira o valor no Existing app password campo.
Selecione Usar o registro de aplicativo existente e insira a ID do aplicativo e o segredo do aplicativo do Azure registrados 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 seu bot do Azure foi criado.

Para adicionar o canal do Microsoft Teams:

Vá para a Página Inicial.
Abra o bot, que está listado na seção Recursos recentes.
Selecione Canais no painel esquerdo e selecione Microsoft Teams na lista de canais disponíveis.
Marque a caixa de seleção para aceitar os termos de serviço e selecione Concordar.
Selecione Salvar.
Selecione o Microsoft Teams e selecione a guia Chamada na página do canal do Teams.
Selecione Habilitar chamada e, em seguida, atualize o Webhook com a URL do ngrok HTTPS (https://yourNgrok/api/callback) e adicione /api/callback no final.
Selecione Salvar.

Para adicionar o ponto de extremidade de mensagens:

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

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

Atualizar e criar o Pacote de Aplicativos do Teams

4 minutos restantes

Configure o exemplo de bot para entender como autenticar o bot de conversa no Microsoft Teams, criar o Pacote de Aplicativos do Teams e carregá-lo para a organização.

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

Atualize appsettings para chamar o 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.
Observe o caminho do repositório baixado.
No Explorador de Arquivos, vá para a pasta csharp 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 partir MicrosoftAppId da página de configuração do bot. O MicrosoftAppPassword valor da ID de segredo do cliente que você salvou anteriormente.
- Você pode obter o Tenant ID ou UserId do link da conta usada para fazer logon no Teams. Siga o caminho na imagem para obter o link para tenant id.
- Você pode obter o e DisplayName do UserId site do Explorador do Microsoft Graph .
  - Faça logon na página usando sua conta do Teams Users e adicione ao final da URl na caixa de pesquisa e selecione Executar consulta.
  - Nomes de exibição e IDs de usuário vinculados à sua conta são gerados.
  - Escolha três contas e adicione-as ao DisplayName e UserId em appsettings.json.
Observação

Tenant ID ou UserId da conta do Teams indica de onde você deseja iniciar a chamada e DisplayName UserId dos usuários indica para quem você deseja redirecionar ou transferir a chamada.
SubstituaMicrosoftAppId, ClientIdpela AppId ID MicrosoftAppPassworddo aplicativo (cliente) e pelo ClientSecret``AppSecret valor.
Atualize BotBaseUrl com sua ngrok URL.
Atualizar Tenant ID e UserId.
Atualizar DisplayName e UserId.
Selecione Salvar.

Para atualizar o manifesto:

No Explorador de Arquivos, vá para a pasta manifesto csharp > microsoft-Teams-Samples-main > samples > bot-calling-meeting > .
Abra o arquivo manifest.json no Visual Studio.
No arquivo manifest.json , localize {id}, {BotId} e adicione sua ID de Aplicativo da Microsoft.
Adicione sua URL ngrok em validDomains excluindo https:// e salvar.
Compacte o conteúdo da pasta Manifesto a ser criada manifest.zip.

Observação

Não manifest.zip deve conter nenhuma pasta extra nele. Ele deve ter o manifest json arquivo de origem, color o ícone e o outline í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 Armazenar > Gerenciar seus aplicativos > carregar manifest.zip um aplicativo personalizado e abrir 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.

Interação 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 dentro de um canal ou em um chat.

Siga as etapas para usar o bot:

No painel esquerdo do Teams, selecione as reticências e escolha seu aplicativo na lista.
O bot enviará texto de boas-vindas com Cartão Adaptável, conforme mostrado abaixo.
Você pode pedir ao bot para criar uma chamada.
Você pode pedir ao bot para transferir a chamada.
Você pode pedir ao bot para agendar uma reunião e convidar os participantes.

Desafio completo

1 minutos restantes

Você conseguiu algo assim?