Criar um bot que possa enviar mensagens proativas para o Microsoft Teams

  • 3 minutos

A extensão Teams Toolkit for Visual Studio Code fornece vários modelos de aplicação baseados em cenários para a criação de bots. O modelo de aplicação baseado no cenário do bot de Notificação de Chat cria um bot que pode ser acionado para enviar uma notificação proativa para o Microsoft Teams. Uma mensagem proativa é uma mensagem enviada em resposta a um evento externo ou acionador. Irá utilizar este modelo para criar um bot na próxima unidade.

Observação

O exercício neste módulo utiliza o Teams Toolkit v5.0.0.

Componentes para criar um bot

Para desenvolver um bot para o Teams, precisa de:

  • Um servidor Web para alojar e executar o código do bot.
  • Um bot do Azure Bot Service para disponibilizar o bot ao Teams.
  • Uma aplicação Microsoft Entra para registar o bot na Microsoft Cloud.
  • Um serviço de túnel HTTP para fornecer um URL acessível publicamente para o ponto final local que é utilizado para receber mensagens do serviço de bot.
  • Um pacote de aplicações do Microsoft Teams para implementar o bot no Teams. Este pacote tem o ficheiro de manifesto da aplicação, que descreve as capacidades do bot e onde o bot pode ser instalado (chat, canal, reunião, aplicação pessoal).

Configuração simplificada

O Teams Toolkit for Visual Studio Code processa a complexidade de criar e configurar os recursos necessários para desenvolver um bot. Quando executa o bot pela primeira vez, este executa os seguintes passos:

  1. Verifica e instala os pré-requisitos.
  2. Inicia um túnel HTTP com o serviço VisualStudio Dev Tunnels.
  3. Cria um registo da aplicação Microsoft Entra.
  4. Cria um registo do Azure Bot Service.
  5. Compila o código do bot e inicia um servidor Web local.
  6. Gera um pacote de aplicações do Teams.
  7. Implementa o pacote de aplicações no Teams.
  8. Inicia uma sessão de depuração.
  9. Abre uma janela do browser, acede a um cliente Web do Teams e apresenta uma caixa de diálogo de instalação da aplicação.

Mensagens proativas

Para acionar uma mensagem proativa a ser enviada para o Teams, envie um pedido HTTP POST para o ponto final de notificação alojado no servidor Web local. Pode utilizar qualquer cliente HTTP para enviar o pedido. Por exemplo, pode utilizar uma ferramenta de linha de comandos como o cURL ou o PowerShell, uma aplicação de ambiente de trabalho como o Postman ou um serviço cloud como as Funções do Azure.

Cartões ajustáveis

Um bot pode enviar cartões interativos denominados cartões adaptáveis para o Teams como mensagens proativas. Os cartões ajustáveis fornecem uma forma avançada e flexível de criar experiências avançadas, consistentes e interativas que podem ser utilizadas numa vasta gama de plataformas e dispositivos.

No próximo exercício, irá aprender a criar um bot para o Teams com o modelo de aplicação baseada em cenários de Bot de notificação . Também irá aprender a acionar o bot para enviar um cartão adaptável para o Teams a partir da linha de comandos.