Exercício – criar um bot que pode enviar mensagens proativas para o Microsoft Teams

  • 5 minutos

Neste exercício, irá aprender a criar, executar e depurar o bot. Também irá aprender a acionar o bot para enviar um cartão adaptável para o Microsoft Teams a partir da linha de comandos.

Criar o bot

  1. Abra o Visual Studio Code.

  2. Na barra lateral, selecione o ícone do Microsoft Teams para abrir o painel TEAMS TOOLKIT .

  3. No painel TOOLKIT do TEAMS , selecione o botão Criar uma Nova Aplicação .

  4. No menu Novo Projeto , selecione Bot.

    Captura de ecrã do Visual Studio Code que mostra as seleções para começar a criar um novo bot com o Teams Toolkit.

  5. No menu Funcionalidades da Aplicação Utilizar um Bot , selecione a funcionalidade Mensagem de Notificação de Chat .

    Captura de ecrã a mostrar o Visual Studio Code que mostra as Funcionalidades da Aplicação com um menu Bot para o Teams Toolkit e a funcionalidade Mensagem de Notificação de Chat.

  6. No menu Escolher acionadores , selecione Acionador HTTP (Funções do Azure).

  7. No menu Linguagem de Programação , selecione JavaScript.

  8. No menu da pasta Área de Trabalho , selecione Pasta predefinida.

  9. No campo Nome da aplicação , introduza Alertas de Pedidos de Suporte e, em seguida, selecione a tecla Enter.

O Teams Toolkit cria automaticamente os ficheiros de código fonte e de projeto.

Observação

Poderá receber uma mensagem do Visual Studio Code a perguntar se confia nos autores dos ficheiros nesta pasta. Selecione o botão Sim, confio nos autores para continuar.

Captura de ecrã do Visual Studio Code que mostra o ficheiro readme do modelo do bot de notificação e os ficheiros de código no painel Explorador.

Executar e depurar

Agora está na altura de executar o bot pela primeira vez.

  1. Na barra lateral, selecione o ícone Depurar para abrir o painel EXECUTAR E DEPURAR .

  2. No painel EXECUTAR E DEPURAR , selecione Chrome ou Edge na caixa de lista pendente como o browser que pretende utilizar para depurar o bot. Em seguida, selecione o botão Reproduzir (ou selecione a tecla F5) para iniciar a sessão de depuração.

    Captura de ecrã do Visual Studio Code que mostra o código do bot de notificação, o painel de depuração e as tarefas de terminal.

    Observação

    Se ainda não iniciou sessão no seu inquilino do Microsoft 365, ser-lhe-á pedido. Selecione Iniciar Sessão e siga os passos de início de sessão para autenticar o Teams Toolkit com o seu inquilino do Microsoft 365.

    Em seguida, o Teams Toolkit implementa, configura e inicia todos os componentes necessários. Também abre uma janela do browser e acede ao Microsoft Teams.

  3. Na caixa de diálogo de instalação, selecione o botão Adicionar para instalar a aplicação como uma aplicação pessoal.

É tudo. O bot está instalado, em execução no Teams e pronto para ser testado.

Captura de ecrã do cliente Web do Teams que mostra uma janela de chat de bot vazia para alertas de pedidos de suporte.

Acionar uma mensagem proativa

Ao utilizar uma ferramenta de linha de comandos, envie um pedido HTTP POST para o ponto final de notificação alojado no servidor Web local para acionar o bot para enviar uma mensagem para o Teams.

curl -X POST http://localhost:3978/api/notification

O bot envia um cartão ajustável para a conversa do Teams.

Captura de ecrã do cliente Web do Teams que mostra um cartão ajustável que foi publicado no chat do bot para obter alertas de pedidos de suporte.

Feche a janela do browser para parar a sessão de depuração.