Criar um bot de conversação do Teams

O bot de conversação do Microsoft Teams permite que os utilizadores interajam com o seu serviço Web através de texto, cartões interativos e caixas de diálogo (referidos como módulos de tarefas no TeamsJS v1.x). As conversações básicas são processadas através do conector do Bot Framework, uma única API REST. Esta API permite que o bot comunique com o Teams e outros canais.

Principais funcionalidades do SDK do Bot Builder

• Fornece acesso ao conector do Bot Framework.
• Gere o fluxo e o estado da conversação.
• Incorpora serviços cognitivos, como o Processamento de Linguagem Natural (NLP).

Quando o bot é adicionado a um grupo ou equipa, é enviada uma mensagem de introdução. A mensagem fornece uma breve descrição das funcionalidades do bot e como utilizá-las.

Este guia passo a passo ajuda-o a criar um bot de conversação na aplicação Teams. Pode ver o seguinte resultado:

Pré-requisitos

• 16 minutos restantes

Certifique-se de que instala as seguintes ferramentas e configura o seu ambiente de desenvolvimento:

Configurar o ambiente local

• 15 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 Microsoft Entra aplicação

• 14 minutos restantes

Registe o bot no Azure Bot Service quando o desenvolver e alojar no Azure. Seguem os passos:

• Registe o bot no Azure Bot Service.

• Crie o segredo do cliente que permite a autenticação de início de sessão único (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 de desenvolvimento 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 Microsoft Entra ID inquilino - 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

  • túnel dev
  • ngrok

  1. Abra o Visual Studio.

  2. Selecione Abrir um projeto ou solução.

     

  3. Aceda a Microsoft-Teams-Samples samples >> bot-conversation > csharp.

  4. Selecione TeamsConversationBot.sln ficheiro.

  5. É apresentada uma janela de descrição geral.

     

  6. Na lista pendente de depuração, selecione Túneis de Desenvolvimento (sem túnel ativo)>Criar um Túnel....

     

     Uma janela pop-up será exibida.

  7. Atualize os seguintes detalhes na janela de pop-up:

     1. Conta: introduza uma conta Microsoft ou GitHub.
     2. Nome: introduza um nome para o túnel.
     3. Tipo de Túnel: na lista pendente, selecione Temporário.
     4. Acesso: na lista pendente, selecione Público.

  8. Selecione OK.

     

     É apresentada uma janela de pop-up que mostra que o túnel dev foi criado com êxito.

  9. Selecione OK.

     

     Pode encontrar o túnel que criou na lista pendente de depuração da seguinte forma:

     

  10. Selecione F5 para executar a aplicação no modo de depuração.

  11. Se for apresentada uma caixa de diálogo Aviso de Segurança , selecione Sim.

      

      Uma janela pop-up será exibida.

  12. Selecione Continuar.

      

      A home page do túnel dev é aberta numa nova janela do browser e o túnel dev está agora ativo.

      

  13. Aceda ao Visual Studio e selecione Ver > Saída.

  14. No menu pendente Consola de saída , selecione Túneis Dev.

      A consola Output (Saída ) mostra o URL do túnel dev.

      

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ões de API

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

2. Selecione + Adicionar uma permissão.

   

3. Selecione Microsoft Graph.

4. Selecione Permissões de aplicativos.

5. Selecione Utilizador>Utilizador.Leitura.Tudo.

6. Selecione Adicionar permissões.

   

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 Administração nome a apresentar do consentimento.

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

   • 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:

   

Criar o bot

• 9 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 a ligação do serviço de bot

• 4 minutos restantes

Configure o bot para compreender como autenticar o bot de conversação no Teams, criar o pacote de aplicações do Teams e carregá-lo para a organização.

1. Atualize o ficheiro appsettings.json no Visual Studio.
2. Atualize o ficheiro manifest.json no Visual Studio e comprima-o para o ficheiro zip no Explorador de Arquivos.
3. Execute a sua solução no Visual Studio.
4. Carregue o bot para o Teams.

Para atualizar as appsettings

1. No Explorador de Arquivos, aceda a Microsoft-Teams-Samples samples>>bot-conversation>csharp.

2. Abra o ficheiro appsettings.json no Visual Studio e atualize a configuração do bot.

   • Defina "MicrosoftAppType"como Multi-inquilino.
   • Defina "MicrosoftAppId" para o ID da Aplicação Microsoft do bot.
   • Defina "MicrosoftAppPassword" como Valor dos segredos do cliente do bot.
   • Defina o para o "MicrosoftAppTenantId" seu ID de inquilino.

   

3. Selecione Salvar.

Para atualizar o manifesto

1. No Explorador de Arquivos, aceda a Microsoft-Teams-Samples samples>>bot-conversation>csharp>TeamsApp>appPackage.

   

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

   • Substitua "id"e "botId" no ID da Aplicação Microsoft do bot.
   • Substitua pelo "validDomains" seu domínio ngrok, excluindo https://.

   

3. Zipe o conteúdo da pasta appPackage para criar manifest.zip.

   Observação

   O manifest.zip não pode conter outras pastas no mesmo. Tem de ter manifest json o ficheiro de origem, color o ícone e outline o ícone dentro da pasta zip. Execute a sua solução no Visual Studio e carregue o manifesto no seu inquilino de demonstração para a organização ou a sua conta do Teams.

Para executar a solução no Visual Studio

1. Abra o Visual Studio.

2. Selecione Ficheiro>Abrir>Projeto/Solução.....

   

3. Aceda a Microsoft-Teams-Samples samples>>bot-conversation>csharp.

4. Selecione TeamsConversationBot.c#proj file( Ficheiro TeamsConversationBot.c#proj ).

   

5. Selecione F5 para executar o projeto.

6. Selecione Sim para instalar o certificado.

   

   É apresentada uma página Web com uma mensagem O bot está pronto!

   

Para carregar a aplicação para o Teams

1. No cliente do Teams, selecione o ícone Aplicações .

2. Selecione Gerenciar seus aplicativos.

3. Selecione Carregar uma aplicação.

4. Procure a opção Carregar uma aplicação personalizada. Se a opção estiver visível, o carregamento de aplicações personalizadas está ativado.

   

   Observação

   Contacte o administrador do Teams se não encontrar a opção para carregar uma aplicação personalizada.

5. Selecione Abrir para carregar o ficheiro .zip que criou na pasta appPackage .

   

6. Selecione Adicionar.

   

   Pode interagir com o bot.

Interagir com o bot de conversação

• 3 minutos restantes

Pode interagir com o bot no Teams enviando-lhe uma mensagem ou selecionando um comando na lista de comandos. O bot responde às cadeias.

No painel esquerdo do Teams, selecione Mais aplicações adicionadas (●●●) e, em seguida, selecione a sua aplicação na lista. O bot mostra Sugestões da seguinte forma:

• MentionMe
• Mostrar Bem-vindo
• MessageAllMembers
• MessageAllMembersUsingAadId

MentionMe	Mostrar Bem-vindo	MessageAllMembers
Resultado: O bot responde à mensagem e menção o utilizador.	Resultado: O bot envia o card de boas-vindas para interagir.	Resultado: O bot envia uma mensagem um-para-um para cada membro na conversação atual.
Âmbitos válidos: pessoal, chat de grupo, chat de equipa.	Âmbitos válidos: pessoal, chat de grupo, chat de equipa.	Âmbitos válidos: pessoal, chat de grupo, chat de equipa.

Pode selecionar uma opção na lista de comandos ao escrever @TeamsConversationBot ou O que posso fazer? texto na área de composição e enviá-la.

Desafio completo

• 1 minutos restantes

Encontrou algo assim?

Parabéns!

• 100% concluído!

Concluiu o tutorial para começar a utilizar o bot de conversação para o Microsoft Teams.