Criar Bot para Enviar Mensagens Proativas - Teams

Uma mensagem proativa é uma mensagem enviada por um bot em resposta a comandos simples enviados na conversa de um utilizador. A resposta da mensagem pode estar num dos seguintes formatos:

Mensagem de boas-vindas
Mensagens agendadas
Notificações

Este guia passo a passo ajuda-o a enviar uma mensagem proativa a partir de um bot. Verá o seguinte resultado:

Captura de ecrã a mostrar a mensagem hello proativa no chat do Teams.

Pré-requisitos

9 minutos restantes

Certifique-se de que instala as seguintes ferramentas para criar e implementar as suas aplicações.

	Instalar	Para utilizar
	Microsoft Visual Studio Code	JavaScript ou TypeScript, crie ambientes. Utilize a versão mais recente.
	Microsoft Teams Toolkit	Extensão do Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente.
	Node.js	Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja Node.js tabela de compatibilidade de versões para o tipo de projeto.
	Microsoft Teams	Equipas para colaborar com todas as pessoas com quem trabalha através de aplicações para chat, reuniões, chamadas e tudo num único local.
	Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.
	Conta de programador do Microsoft 365	Acesso à conta do Teams com as permissões adequadas para instalar uma aplicação.

Preparar o ambiente de desenvolvimento

Depois de instalar as ferramentas necessárias, configure o ambiente de desenvolvimento.

Instalar o Teams Toolkit

O Microsoft Teams Toolkit ajuda a simplificar o processo de desenvolvimento com ferramentas para aprovisionar e implementar recursos na cloud para a sua aplicação e publicar na Loja Teams.

Pode utilizar o Teams Toolkit com o Visual Studio Code ou uma interface de linha de comandos denominada CLI do TeamsFx.

Visual Studio Code
Linha de comando

Abra o Visual Studio Code e selecione Extensões (Ctrl+Shift+X ou Ver>Extensões).
Na caixa de pesquisa, introduza Teams Toolkit.
Selecione Instalar.

O ícone do Toolkit do Teams é apresentado na Barra de Atividade do Visual Studio Code.

Também pode instalar o Teams Toolkit a partir do Marketplace do Visual Studio Code.

Para instalar a CLI do TeamsFx, utilize o npm gestor de pacotes e introduza o seguinte comando na Linha de comandos:

npm install -g @microsoft/teamsfx-cli

Consoante a configuração, poderá ter de utilizar sudo para instalar a CLI:

sudo npm install -g --unsafe-perm @microsoft/teamsfx-cli

Esta condição é mais comum em sistemas Linux e macOS.

Certifique-se de que adiciona a cache global do npm ao seu PATH. Normalmente, este passo é feito como parte do instalador do Node.js.

Pode utilizar a CLI com o teamsfx comando . Verifique se o comando está a funcionar ao executar teamsfx -h.

Cuidado

Antes de poder executar o TeamsFx nos terminais do PowerShell, tem de ativar a política de execução assinada remotamente para o PowerShell.

Configurar o seu inquilino de desenvolvimento do Teams

Um inquilino é um espaço ou contentor para a sua organização no Teams, onde conversa, partilha ficheiros e executa reuniões. Este espaço também é onde carrega e testa a sua aplicação. Vamos verificar se está pronto para programar com o inquilino.

Verificar a opção carregar uma aplicação

Depois de criar a sua aplicação personalizada, tem de carregar a sua aplicação para o Teams com a opção Carregar uma aplicação personalizada . Inicie sessão na sua conta do Microsoft 365 para verificar se esta opção está ativada.

Os passos seguintes ajudam-no a verificar se pode carregar aplicações no Teams:

No cliente do Teams, selecione o ícone Aplicações .
Selecione Gerenciar seus aplicativos.
Selecione Carregar uma aplicação.
Procure a opção Carregar uma aplicação personalizada. Se a opção estiver visível, pode carregar aplicações personalizadas.

Observação

Se não encontrar a opção para carregar uma aplicação personalizada, contacte o administrador do Teams.

Criar um inquilino gratuito para programadores do Teams (opcional)

Se não tiver uma conta de programador do Teams, adira ao programa de programador do Microsoft 365.

Acesse o Programa para desenvolvedores do Microsoft 365.
Selecione Aderir Agora e siga as instruções apresentadas no ecrã.
No ecrã de boas-vindas, selecione Configurar a subscrição E5.
Configurar a conta de administrador. Depois de terminar, é apresentado o ecrã seguinte:
Inicie sessão no Teams com a conta de administrador que acabou de configurar. Verifique se tem a opção Carregar uma aplicação personalizada no Teams.

Criar bot de Mensagens Proativas

7 minutos restantes

Para criar um bot de mensagens proativo com o Visual Studio Code, siga estes passos:

Abra o Visual Studio Code.
Selecione o ícone Do Teams Toolkit na Barra de Atividade do Visual Studio Code.
No painel esquerdo, selecione Ver Exemplos.
Na lista de exemplos, selecione Mensagens Proativas. É aberto um exemplo pré-criado pronto para depuração.
Selecione Criar.
Selecione Pasta predefinida para armazenar a pasta raiz do projeto na localização predefinida.

Se quiser alterar a localização predefinida, execute os seguintes passos:
1. Selecione Procurar.
2. Selecione a localização da área de trabalho do projeto.
3. Selecione Selecionar Pasta.
O bot de mensagens proativa é criado em poucos segundos e apresenta a caixa de diálogo com êxito do bot de mensagens proativas no canto inferior direito com a opção de depurar:

:::
Selecione o ícone Executar e Depurar no canto superior esquerdo.
Selecione Depurar (Edge) ou Depurar (Chrome) na lista pendente.

Quando a depuração for efetuada com êxito, ser-lhe-á pedido para carregar o bot de mensagens proativas para o Teams no seu computador local.
No menu pendente junto a Adicionar, selecione Adicionar a uma equipa ou Adicionar a uma conversa ou Adicionar a uma reunião.
Introduza o nome de uma conversa ou equipa no campo de pesquisa e selecione Configurar um bot.

A aplicação de bot de mensagem proativa é carregada para o cliente do Teams e a seguinte mensagem é apresentada em resposta à mensagem enviada.
Copie e cole o URL ou navegue para o URL no browser. Uma mensagem hello proativa é acionada e partilhada no chat.
Aceda ao Teams. Receberá uma mensagem de olá proativa do bot.

Faça um tour pelo código-fonte

O Teams Toolkit fornece componentes para criar uma aplicação. Depois de criar o projeto, pode ver as pastas e os ficheiros do projeto na área EXPLORER do Visual Studio Code.

Captura de ecrã a mostrar o separador estrutura.

A nova pasta do projeto contém o seguinte conteúdo:

Pasta/Ficheiro	Conteúdos
`.vscode/`	Ficheiros do Visual Studio Code para depuração.
`appManifest/`	Modelos para o manifesto da aplicação (anteriormente denominado manifesto de aplicação do Teams).
`env/`	Os pares nome/valor são armazenados em ficheiros de ambiente e utilizados por `teamsapp.yml` para personalizar as regras de aprovisionamento e implementação.
`manifest.json`	O manifesto da aplicação para publicação através do Portal do Programador do Teams é armazenado no `Properties/manifest.json`.
`teamsapp.yml`	O ficheiro de projeto principal descreve a configuração da aplicação e define o conjunto de ações a executar em cada fase do ciclo de vida.
`teamsapp.local.yml`	Isto substitui `teamsapp.yml` por ações que permitem a execução local e a depuração.

Implementar o bot de mensagens Proativas

4 minutos restantes

Aprendeu a criar e executar a aplicação Teams com capacidade de bot de mensagens proativa. Vamos implementar a primeira aplicação com a capacidade de bot de mensagens proativas no Azure com o Teams Toolkit.

Utilize a sua conta para aceder ao portal do Microsoft Azure e aprovisionar novos recursos na cloud para suportar a sua aplicação.

Abra o Visual Studio Code.
Abra a pasta do projeto onde criou a aplicação de bot de mensagens proativa.
Selecione o ícone Do Teams Toolkit na Barra de Atividade do Visual Studio Code.
Selecione Iniciar sessão no Azure com as suas credenciais.

Dica

Se tiver a extensão conta do AZURE instalada e estiver a utilizar a mesma conta, pode ignorar este passo.

O browser predefinido é aberto para lhe permitir iniciar sessão na conta.
Feche o browser quando lhe for pedido e regresse ao Visual Studio Code.

A secção CONTAS da barra lateral mostra as duas contas separadamente. Também lista o número de subscrições utilizáveis do Azure disponíveis para si. Certifique-se de que tem, pelo menos, uma subscrição utilizável do Azure disponível. Caso contrário, termine sessão e utilize uma conta diferente.

Implantar seu aplicativo no Azure.

A implementação consiste em dois passos. Em primeiro lugar, são criados os recursos da cloud necessários (também conhecidos como aprovisionamento). Em seguida, o código da sua aplicação é copiado para os recursos da cloud criados. Neste tutorial, irá implementar a aplicação de bot.

Qual é a diferença entre Aprovisionar e Implementar?

O aprovisionamento cria recursos no Azure e no Microsoft 365 para a sua aplicação, mas nenhum código (HTML, CSS e JavaScript) é copiado para os recursos. Implementar copia o código da sua aplicação para os recursos que criou durante o aprovisionamento. É comum implementar várias vezes sem aprovisionar novos recursos. Uma vez que o aprovisionamento pode demorar algum tempo a ser concluído, é separado da implementação.

Visual Studio Code
Linha de comando

Selecione o ícone Do Teams Toolkit na Barra de Atividade do Visual Studio Code.
Selecione Aprovisionar em CICLO DE VIDA.
Selecione uma das subscrições existentes.
Selecione um grupo de recursos existente ou crie um novo grupo de recursos. Para obter mais informações, veja Criar grupo de recursos.

Observação

É apresentada uma caixa de diálogo que menciona que podem ser incorridos custos ao executar recursos no Azure.
Selecione Aprovisionar.

O processo de aprovisionamento cria recursos na cloud do Azure. Pode monitorizar o progresso nas caixas de diálogo que aparecem no canto inferior direito. Após alguns minutos, é apresentada a seguinte caixa de diálogo:
Selecione Implementar em CICLO DE VIDA.
Selecione Implantar.

A implementação demora algum tempo. Pode monitorizar o progresso nas caixas de diálogo que aparecem no canto inferior direito. Após alguns minutos, é apresentada a seguinte caixa de diálogo.
Abra o painel de depuração (Ctrl+Shift+D / ⌘⇧-D ou Ver Execução>) a partir do Visual Studio Code.
Selecione Iniciar Remoto (Edge) na lista pendente iniciar configuração.

Quando a depuração for efetuada com êxito, ser-lhe-á pedido para carregar a aplicação de bot de mensagens proativa para o Teams.
No menu pendente junto a Adicionar, selecione Adicionar a uma equipa ou Adicionar a uma conversa ou Adicionar a uma reunião.
Introduza o nome de uma conversa ou equipa no campo de pesquisa e selecione Configurar um bot.

A aplicação de bot de mensagem proativa é carregada para o cliente do Teams e a seguinte mensagem é apresentada em resposta à mensagem enviada.
Copie e cole o URL ou navegue para o URL no browser. Uma mensagem hello proativa é acionada e partilhada no chat.
Aceda ao Teams. Receberá uma mensagem de olá proativa do bot.

Na janela do terminal:

Execute teamsfx new para criar um novo projeto.
```
teamsfx new
```
Execute teamsfx provision para criar um recurso do Azure.
```
teamsfx provision
```
Execute teamsfx deploy para implementar a aplicação.
```
teamsfx deploy
```
Execute teamsfx preview para executar a aplicação.
```
teamsfx preview
```

Desafio completo

3 minutos restantes

Encontrou algo assim?

Captura de ecrã a mostrar a mensagem hello proativa.

Parabéns!

100% concluído!

Concluiu o cenário.

Pode enviar notificações diariamente ou pedir feedback aos utilizadores periodicamente.
Pode processar limites de limitação para evitar várias notificações.

Compartilhar via

Enviar Mensagens Proativas