Criar bot de conversa do Teams
Os bots de conversa do Teams permitem que os usuários interajam com seu serviço Web por meio de texto, cartões interativos e módulos de tarefa. As conversas básicas são tratadas por meio do conector do Bot Framework, uma única API REST. Essa API permite que seu bot se comunique com o Teams e outros canais. O SDK do Construtor de Bots fornece os seguintes recursos:
- Acesso fácil ao conector do Bot Framework.
- Funcionalidade adicional para gerenciar o fluxo e o estado da conversa.
- Maneiras simples de incorporar serviços cognitivos, como o NLP (processamento de linguagem natural).
Quando o bot é adicionado pela primeira vez a um grupo ou equipe, uma mensagem de introdução é enviada. A mensagem fornece uma breve descrição dos recursos do bot e como usá-los.
Este guia passo a passo ajuda você a criar um bot de conversa básico no aplicativo teams. Você verá a seguinte saída:
Pré-requisitos
Para configurar seu ambiente de desenvolvimento, instale as seguintes ferramentas:
| 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 | 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 chat, reuniões, chamadas e tudo em um só lugar. |
Configurar bot de conversa
Registre o bot com o serviço de bot do Azure ao desenvolvê-lo e hospedá-lo no Azure. Execute as etapas a seguir:
- Use o ngrok para criar um túnel para os pontos de extremidade do servidor Web.
- Criar registro de canal de bot na conta do Azure.
- Crie o segredo do cliente que habilita a autenticação SSO do bot.
- Adicione permissões de API para chamadas downstream.
- Adicione o ponto de extremidade de mensagens ao túnel ngrok que você criou.
- Adicione o canal do Microsoft Teams para implantar o bot em um canal do Teams.
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
Criar registro de canal do 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.
Digite o nome do identificador do bot no campo Identificador do bot.
Selecione sua Assinatura na lista suspensa.
Selecione seu grupo de recursos existente na lista suspensa ou crie um novo grupo de recursos, selecione Criar novo, insira o nome do recurso, selecione OK e selecione o local necessário na lista suspensa Local do novo grupo de recursos .
Selecione residência de dados necessária (versão prévia).
Selecione o Tipo de Aplicativo Multilocatário para a ID de Aplicativo da Microsoft.
Observação
Na seção Criação da ID do Aplicativo Microsoft, Criar nova ID de Aplicativo da Microsoft já está selecionado para criar um novo bot. Você também pode selecionar Usar o registro de aplicativo existente, se já tiver registrado um bot. Insira a ID do Aplicativo Microsoft no campo ID do aplicativo existente e insira valor no campo Senha de aplicativo existente .
Selecione Rever + criar.
Selecione Criar, se a validação for aprovada. 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 criar o segredo do cliente
Em Configurações, selecione Configurar. Salve a ID de Aplicativo da Microsoft (ID do cliente) para referência futura.
Selecione Gerenciar adjacente à ID do Aplicativo Microsoft.
Na seção Segredos do cliente , selecione Novo segredo do cliente. A janela Adicionar um segredo do cliente é exibida.
Digite uma Descrição e selecione Adicionar.
Selecione Copiar para área de transferência na coluna Valor e salve a ID de segredo do cliente para referência futura.
Para adicionar permissões de API para chamadas downstream
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 e selecione Microsoft Graph.
Selecione Permissões de aplicativo e selecione permissões.
Adicione todas as permissões de usuário que seu aplicativo requer para APIs downstream, por exemplo,
User.Read.Selecione Adicionar permissões.
Para adicionar ponto de extremidade de mensagens
Vá para Página Inicial 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 de mensagens, adicione a URL HTTPS disponível no ngrok e no final da URL adicionar /api/mensagens.
Selecione Aplicar.
Para adicionar o canal do Microsoft Teams
Vá para a Página Inicial.
Na seção Recursos recentes , abra o bot.
Selecione Canais no painel esquerdo e selecione Microsoft Teams
da lista de canais disponíveis.
Marque a caixa de seleção para aceitar os termos de serviço e selecione Concordar.
Selecione Salvar.
Você configurou com êxito um bot no Azure Serviço de Bot e agora precisa configurar a conexão do serviço de bot.
Configurar a conexão do serviço de bot
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 no arquivo zip no Explorador de Arquivos.
- Execute sua solução no Visual Studio.
- Carregue o bot no Teams.
Atualizar appsettings para bot de conversa
Vá para o repositório https://github.com/Microsoft/botbuilder-samples.git.
Selecione Código e selecione a lista suspensa.
Selecione Baixar ZIP.
Verifique o caminho do repositório que você baixou.
No Explorador de Arquivos, acesse exemplos de botbuilder-samples > > csharp_dotnetcore > 57.teams-conversation-bot.
Abra o arquivo appsettings.json no Visual Studio e atualize a configuração do bot.
Adicione o nome do bot para
MicrosoftAppType.Você pode obter a
MicrosoftAppIdna página de configuração do bot. OMicrosoftAppPasswordé a ID de segredo do valor do cliente que você salvou anteriormente.Você pode obter o
MicrosoftAppTenantIdouUserIddo link da conta usada para fazer logon no Teams. Siga o caminho na imagem para obter o link paratenant id:
Copie a ID do locatário da URL.
Selecione Salvar.
Para atualizar manifesto
No Explorador de Arquivos, acesse exemplos de botbuilder-samples > > csharp_dotnetcore > 57.teams-conversation-bot > TeamsAppManifest.
Abra o arquivo manifest.json no Visual Studio.
No arquivo manifest.json , localize {id}, {botId} e adicione sua ID do Aplicativo Microsoft.
Adicione sua url ngrok em validDomains excluindo e salvando
https://.
Feche o conteúdo da pasta TeamsAppManifest para criar manifest.zip.
Observação
O
manifest.zipnão deve conter pastas adicionais nela. Ele deve termanifest jsono arquivo de origem,coloro ícone eoutlineo ícone dentro da pasta zip. Execute sua solução no Visual Studio e carregue seu manifesto em seu locatário de demonstração para a organização ou sua conta do Teams.
Para executar a solução no Visual Studio
Abra o Visual Studio.
Selecione Arquivo e selecione Abrir.
Selecione Projeto/Solução para abrir o
.csprojarquivo no Explorador de Arquivos.Acesse exemplos de botbuilder-samples > > csharp_dotnetcore > 57.teams-conversation-bot.
Selecione
TeamsConversationBot.csprojo arquivo e selecione o bot na lista Projetos de Inicialização .
Selecione F5 para depurar. Você receberá uma tela de confirmação quando o bot estiver pronto.
Para carregar o aplicativo no Teams
Vá para o Teams.
Para carregar manifest.zip, selecione Armazenar > Gerenciar seus aplicativos > Carregar um aplicativo personalizado e abrir manifest.zip no repositório no Explorador de Arquivos.
Selecione Adicionar para instalar o bot de conversa no Teams.
Você pode interagir com esse bot agora.
Interação com o bot de conversa
Você pode interagir com o bot no Teams enviando uma mensagem ou selecionando um comando na lista de comandos. O bot responde às seguintes cadeias de caracteres:
No painel esquerdo do Teams, selecione as reticências ●●● e selecione seu aplicativo na lista. O bot mostra Sugestões da seguinte maneira:
| MentionMe | Mostrar Bem-vindo | MessageAllMembers |
|---|---|---|
|
|
|
| Resultado: O bot responde à mensagem e menciona o usuário. | Resultado: O bot envia o cartão de boas-vindas para você interagir. | Resultado: O bot envia uma mensagem individual para cada membro na conversa atual. |
| Escopos válidos: chat pessoal, em grupo, chat em equipe. | Escopos válidos: chat pessoal, em grupo, chat em equipe. | Escopos válidos: chat pessoal, em grupo, chat em equipe. |
Você pode selecionar uma opção na lista de comandos digitando @TeamsConversationBot na área de mensagem de composição e o que posso fazer? texto acima da área de composição.
Desafio completo
Você veio com algo assim?
Parabéns!
Você concluiu o tutorial para começar a usar o bot de conversa para o Microsoft Teams.
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.