Guia de início rápido da experiência de configuração do bot

Observação

A experiência de configuração do bot tem suporte apenas em escopos de chat de canal ou grupo.

Inicie o desenvolvimento de aplicativos do Microsoft Teams com seu primeiro aplicativo do Teams. Você pode criar um aplicativo bot com o Teams usando Javascript.

Este guia de início rápido ajuda você a criar um bot configurável com o Teams Toolkit. Você verá a seguinte saída depois de concluir este guia:

A captura de tela mostra a opção de configuração do bot em um chat de grupo do Teams.

Pré-requisitos

6 minutos restantes

Verifique se você instala as seguintes ferramentas para criar e implantar seus aplicativos.

	Instalar	Para usar...
	Kit de ferramentas do Teams	Uma extensão do Microsoft Visual Studio Code que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente.
	Microsoft Teams	Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamar tudo em um só lugar.
	Node.js e NPM	Ambiente de runtime do JavaScript de back-end. Para obter mais informações, consulte Node.js tabela de compatibilidade de versão para o tipo de projeto.
	Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
	Visual Studio Code	Ambientes de compilação JavaScript, TypeScript ou Estrutura do SharePoint (SPFx). Use a versão mais recente.
	Túnel de desenvolvimento	Os recursos do aplicativo Teams (bots de conversa, extensões de mensagem e webhooks de entrada) precisam de conexões de entrada. Um túnel conecta seu sistema de desenvolvimento ao Teams. O túnel de desenvolvimento é uma ferramenta poderosa para abrir com segurança seu localhost para a Internet e controlar quem tem acesso. O túnel de desenvolvimento está disponível no Visual Studio 2022 versão 17.7.0 ou posterior. ou você também pode usar o ngrok como um túnel para conectar 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).

Observação

Depois de baixar o ngrok, inscreva-se e instale authtoken.

Configurar o ambiente local

5 minutos restantes

Abra exemplos do Microsoft Teams.
Selecione Código. No menu suspenso, selecione Abrir com o GitHub Desktop.
Selecione Clonar.

Configurar túnel para o servidor Web local

4 minutos restantes

Use o ngrok ou o Prompt de Comando 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=localhost 3978

Dica

Se você encontrar ERR_NGROK_4018, siga as etapas fornecidas no Prompt de Comando para se inscrever e autenticar o ngrok. Em seguida, execute o comando ngrok http --host-header=localhost 3978.

A janela mostra a URL HTTPS.

A captura de tela mostra a URL HTTPS do ngrok.

Compilar e executar seu aplicativo

3 minutos restantes

Vá para Visual Studio Code.
Selecione Abrir uma pasta, acesse Exemplos do Microsoft-Teams-Samples>>bot-configuration-app e selecione Selecionar pasta.
No painel esquerdo, selecione Kit de Ferramentas do Teams.
Em CONTAS, entre no seguinte:
- Conta do Microsoft 365
- Conta do Azure
Para depurar seu aplicativo, insira F5.

Uma guia do navegador abre um cliente Web do Teams solicitando adicionar o bot ao seu locatário.
Na lista suspensa ao lado de Adicionar, selecione Adicionar a uma equipe ou Adicionar a um chat.
Insira o nome de um chat no campo de pesquisa.
Selecione Configurar um bot.

O bot está instalado no chat.

Reconfigurar o bot

2 minutos restantes

Acesse o chat e @menção o bot na área de composição de mensagens e selecione Enviar.
Quando você passa o mouse sobre o bot da conversa, um Cartão Adaptável é exibido. Selecione o ícone Configurações no Cartão Adaptável.

Um cartão adaptável de configuração de bot é exibido.
Reconfigure as configurações do bot e selecione Enviar.
O bot envia uma mensagem de resposta.