Gerar token de reunião

A aplicação Token de reunião ajuda a melhorar a sua experiência de reunião no Teams ao permitir que os participantes da reunião peçam tokens e gerem tokens. A aplicação gera tokens sequencialmente para que cada participante tenha a mesma oportunidade de interagir na reunião. Por exemplo, a aplicação é útil nas sessões Q&A e em reuniões, como reuniões scrum.

Principais funcionalidades do gerador de tokens de reunião

• Apresenta o token atual utilizado na reunião.
• Apresenta a lista de utilizadores ordenada com base no número do token.
• Gera um token para o utilizador mediante pedido.
• Apresenta o número de token do utilizador atual.
• Permite que o organizador ignore o token de reunião atual.

Diferentes formas de interações do utilizador

• Token: token de pedidos para o utilizador.

• Concluído: confirma a geração de tokens para o utilizador.

• Ignorar: ignora o utilizador atual e passa para a pessoa seguinte na fila para obter um token.

  Observação

  Ignorar só está disponível para os organizadores da reunião.

Este guia passo a passo ajuda-o a gerar o token de reunião para que todos os participantes interajam na reunião. Verá o seguinte resultado:

Pré-requisitos

• 19 minutos restantes

Instale as seguintes ferramentas e configure o seu ambiente de desenvolvimento:

Tem de ter conhecimentos práticos das seguintes tecnologias:

Configurar o ambiente local

• 18 minutos restantes

1. Abra Microsoft-Teams-Samples.

2. Selecione Código.

3. No menu pendente, selecione Abrir com o GitHub Desktop.

   

4. Selecione Clonar.

Registar a aplicação Microsoft Entra

• 17 minutos restantes

Os passos seguintes ajudam-no a criar e registar o bot no portal do Azure:

• Crie e registe a sua aplicação do Azure.
• Crie o segredo do cliente para ativar a autenticação SSO do bot.
• Adicione o canal do Teams para implementar o bot.
• Crie um túnel para os pontos finais do servidor Web com o túnel dev (recomendado) ou o ngrok.
• Adicione o ponto final de mensagens ao túnel dev que criou.

Adicionar Registo de aplicações

1. Acesse o portal do Azure.

2. Selecione Registros de aplicativos.

   

3. Selecione + Novo registo.

   

4. Introduza o nome da sua aplicação.

5. Selecione Contas em qualquer diretório organizacional (Qualquer inquilino do Microsoft Entra ID – Multi-inquilino).

6. Selecione Registrar.

   

   A sua aplicação está registada no Microsoft Entra ID. É apresentada a página de descrição geral da aplicação.

   

   Observação

   Guarde o ID da aplicação do ID da Aplicação (cliente) e do ID do Diretório (inquilino) para utilização adicional.

Criar um túnel

ngrok http --host-header=localhost 3978

Adicionar uma autenticação Web

1. No painel esquerdo, em Gerir, selecione Autenticação.

2. Selecione Adicionar uma Web de plataforma>.

   

3. Introduza o URI de redirecionamento para a sua aplicação ao acrescentar auth-end ao nome de domínio completamente qualificado. Por exemplo: https://your-devtunnel-domain/auth-end ou https://your-ngrok-domain/auth-end.

4. Em Concessão implícita e fluxos híbridos, selecione as caixas de verificação Tokens de acesso e tokens de ID .

5. Selecione Configurar.

   

6. Em Web, selecione Adicionar URI.

7. Digite https://token.botframework.com/.auth/web/redirect.

8. Selecione Salvar.

   

Criar um segredo do cliente

1. No painel esquerdo, em Gerir, selecione Certificados & segredos.

2. Em Segredos do cliente, selecione + Novo segredo do cliente.

   

   É apresentada a janela Adicionar um segredo do cliente .

3. Introduza Descrição.

4. Selecione Adicionar.

   

5. Em Valor, selecione Copiar para a área de transferência para guardar o valor do segredo do cliente para utilização adicional.

   

Adicionar permissão de API

1. No painel esquerdo, em Gerir, selecione Permissões da API.

2. Selecione + Adicionar uma permissão.

   

3. Selecione Microsoft Graph.

4. Selecione Permissões delegadas.

5. Selecione as seguintes permissões:

   • Permissões> de OpenIde-mail, offline_access, openid, perfil.
   • Utilizador>User.Read.

6. Selecione Adicionar permissões.

   

   Observação

   • Se não for concedido consentimento ao administrador de TI a uma aplicação, os utilizadores têm de dar consentimento na primeira vez que utilizarem uma aplicação.
   • Os utilizadores só precisam de dar consentimento às permissões da API se a aplicação Microsoft Entra estiver registada num inquilino diferente.

Adicionar URI do ID da Aplicação

1. No painel esquerdo, em Gerir, selecione Expor uma API.

2. Junto a URI do ID da Aplicação, selecione Adicionar.

   

3. Atualize o URI do ID da Aplicação no api://your-devtunnel-domain/botid-{AppID} formato ou api://your-ngrok-domain/botid-{AppID} e selecione Guardar.

   

   A imagem seguinte mostra o nome de domínio:

   

Adicionar um âmbito

1. No painel esquerdo, em Gerir, selecione Expor uma API.

2. Selecione + Adicionar um âmbito.

   

3. Introduza access_as_user como o Nome do âmbito.

4. Em Quem pode consentir?, selecione Administradores e utilizadores.

5. Atualize os valores dos restantes campos da seguinte forma:

   • Introduza O Teams pode aceder ao perfil do utilizador como Nome a apresentar do consentimento do administrador.

   • Introduza Permite que o Teams chame as APIs Web da aplicação como o utilizador atual como Descrição do consentimento do administrador.

   • Introduza O Teams pode aceder ao perfil de utilizador e fazer pedidos em nome do utilizador como Nome a apresentar do consentimento do utilizador.

   • Introduza Ativar o Teams para chamar as APIs desta aplicação com os mesmos direitos que o utilizador que aDescrição do consentimento do utilizador.

6. Verifique se o Estado está definido como Habilitado.

7. Selecione Adicionar escopo.

   A imagem seguinte mostra os campos e os valores:

   

   Observação

   O Nome do âmbito tem de corresponder ao URI do ID da Aplicação com /access_as_user acrescentado no final.

   

Adicionar aplicação cliente

1. No painel esquerdo, em Gerir, selecione Expor uma API.

   Em Aplicações cliente autorizadas, identifique as aplicações que pretende autorizar para a aplicação Web da sua aplicação.

2. Selecione + Adicionar uma aplicação cliente.

   

3. Adicione o Teams para dispositivos móveis ou de ambiente de trabalho e a aplicação Web do Teams.

   1. Para dispositivos móveis ou de ambiente de trabalho do Teams: introduza o ID de Cliente como 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. Para a Web do Teams: introduza o ID de Cliente como 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Selecione a caixa de verificação Âmbitos autorizados .

5. Selecione Adicionar aplicativo.

   

   A imagem seguinte apresenta o ID de Cliente:

   

Atualizar o manifesto

1. No painel esquerdo, selecione Manifesto.

2. Defina o valor para accessTokenAcceptedVersion2 e selecione Guardar.

   

Criar o bot

• 12 minutos restantes

Criar um recurso de bot do Azure

1. Vá para a Página Inicial.

2. Selecione + Criar um recurso.

3. Na caixa de pesquisa, introduza Azure Bot.

4. Selecione Enter.

5. Selecione Bot do Azure.

6. Selecione Criar.

   

7. Introduza o nome do bot no Identificador do bot.

8. Selecione sua Assinatura na lista suspensa.

9. Selecione seu Grupo de recursos na lista suspensa.

   

   Se não tiver um grupo de recursos existente, pode criar um novo grupo de recursos. Para criar um novo grupo de recursos, siga estes passos:

   1. Selecione Criar novo.
   2. Introduza o nome do recurso e selecione OK.
   3. Selecione uma localização na lista pendente Nova localização do grupo de recursos .

   

10. Em Preços, selecione Alterar plano.

    

11. Selecione Fo Gratuito>Selecionar.

    

12. Em ID da Aplicação Microsoft, selecione Tipo de Aplicação como Multi-Inquilino.

13. No Tipo de criação, selecione Utilizar registo de aplicações existente.

14. Introduza o ID da Aplicação.

    Observação

    Não pode criar mais do que um bot com o mesmo ID da Aplicação Microsoft.

15. Selecione Rever + criar.

    

16. Após a validação passar, selecione Criar.

    O bot demora alguns minutos a aprovisionar.

17. Selecione Vá para o recurso.

    

    Criou com êxito o bot do Azure.

    

Adicionar um canal do Teams

1. No painel esquerdo, selecione Canais.

2. Em Canais Disponíveis, selecione Microsoft Teams.

   

3. Selecione a caixa de verificação para aceitar os Termos de Serviço.

4. Selecione Concordar.

   

5. Selecione Aplicar.

   

Para adicionar um ponto final de mensagens

Configurar as definições da aplicação

• 7 minutos restantes

1. Aceda ao ficheiro appsettings.json no repositório clonado.

   

2. Abra o ficheiro appsettings.json no Visual Studio Code e atualize as seguintes informações:

   • Defina "MicrosoftAppId" para o ID da Aplicação Microsoft do bot.
   • Defina "MicrosoftAppPassword" como o Valor do segredo do cliente do bot.
   • Defina "AzureAd"."TenantId" como o ID de inquilino do inquilino onde a aplicação é utilizada.

   Observação

   O exemplo só funciona no inquilino atual.

   • Defina "AzureAd"."ApplicationId" para o ID da Aplicação Microsoft do bot.
   • Defina "ContentBubbleUrl" como o url (https://[WebAppDomain]/contentBubble.html)iframe de bolha de conteúdo .

   Observação

   WebAppDomain é o seu domínio ngrok, pelo que o URL de bolha de conteúdo é semelhante a https://ae57****.ngrok.io/contentBubble.html.

   

Configurar o ficheiro de manifesto

• 6 minutos restantes

1. Aceda ao manifest.json ficheiro no repositório clonado.

   

2. Abra manifest.json o ficheiro no Visual Studio Code e faça as seguintes alterações:

   • Defina manifestVersion para a versão mais recente.
   • Defina $schema como https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json.
   • Defina resource como api://[WebAppDomainName]/[MicrosoftAppId].
   • Substitua por [companyName]Contoso.
   • Substitua as secções seguintes pelo nome de domínio completamente qualificado:
     • websiteUrl
     • privacyUrl
     • termsOfUseUrl
   • Substitua todas as ocorrências de pelo nome de WebAppDomainName domínio ngrok.
   • Substitua todas as ocorrências de MicrosoftAppId pelo ID da Aplicação Microsoft do bot.

   

Criar uma aplicação cliente com a instalação do npm

• 5 minutos restantes

1. Aceda à pasta ClientApp no repositório clonado.

2. Copie o caminho da pasta ClientApp .

3. Abra uma nova janela da Linha de Comandos , altere o diretório atual para o caminho copiado clientApp .

   

4. Execute o seguinte comando na Linha de Comandos para transferir pacotes e dependências.

   npm install
   

5. Execute o seguinte comando na Linha de Comandos para iniciar a aplicação.

   npm start
   

   

Criar e executar o serviço

• 4 minutos restantes

Para criar e executar o serviço, utilize o Visual Studio ou a Linha de comandos.

 dotnet run

Habilitar a visualização do desenvolvedor

• 3 minutos restantes

1. Ative o carregamento de aplicações na consola de administração do seu inquilino.

   1. Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.

   2. No painel esquerdo, selecione Mostrar Tudo.

   3. Selecione Teams.

      

   4. No painel esquerdo, selecione Aplicações do Teams.

   5. Selecione Políticas de Configuração.

      

   6. Selecione Global.

      

   7. Ativar a posição Ativado em Carregar aplicações personalizadas.

      

   8. Selecione Salvar.

      O inquilino de teste pode permitir o carregamento de aplicações personalizadas.

      Observação

      O carregamento de aplicações personalizadas demora algum tempo a tornar-se ativo.

2. Aceda ao Microsoft Teams.

3. No canto superior direito da interface do Teams, selecione Definições e muito mais(...).

4. Selecione Sobre>Visualização do desenvolvedor.

   

5. Selecione Mudar para pré-visualização do programador.

   

Adicionar token de reunião ao Teams

• 2 minutos restantes

1. No seu repositório clonado, aceda a csharp > AppManifest.

2. Crie um ficheiro .zip com os seguintes ficheiros que estão presentes na pasta AppManifest :

   • manifest.json
   • outline.png
   • color.png

   

3. Crie uma reunião no Teams com alguns apresentadores e participantes.

4. Ingresse na reunião.

5. Após o início da reunião, selecione Aplicações.

6. Na janela de pop-up, selecione Gerir aplicações.

   

7. Selecione Carregar uma aplicação.

8. Selecione o ficheiro .zip que criou na pasta AppManifest e selecione Abrir.

   

9. Selecione Adicionar.

   

   A secção Gerir aplicações apresenta a lista de aplicações.

   

10. Aceda à reunião do Teams.

11. Selecione Ícone da aplicação . Na página de seleção da aplicação, a aplicação é apresentada como Aplicação token de reunião.

    

12. Selecione Aplicação de Tokens de Reunião.

13. Selecione Salvar.

    

    A aplicação está visível no chat da reunião.

14. Inicie a reunião.

    O ícone está visível na barra de controlo da reunião.

    

    Observação

    Quando trabalhar no seu próprio projeto, certifique-se de que utiliza um mecanismo de armazenamento durável para armazenar as informações do token e o URL de serviço do inquilino.

Desafio completo

• 1 minutos restantes

Encontrou algo assim?

Parabéns!

• 100% concluído!

Concluiu o tutorial para começar a utilizar uma aplicação Gerador de Tokens de Reunião.