Criar um bot de notificação interativo

Para uma notificação interativa, um bot envia mensagens em um canal do Teams, chat em grupo ou chat pessoal. Você pode disparar um bot de notificação interativo com uma solicitação HTTP, como cartões ou textos. Para notificações proativas de aplicativos de guia, use notificações de feed de atividades.

Neste tutorial, saiba mais sobre um aplicativo de bot de notificação interativo de uma das seguintes maneiras.

• Codespaces do GitHub: a instância do codespace permite que você experimente um aplicativo do Teams instantaneamente. Ele abre Visual Studio Code (VS Code) em que a extensão do Teams Toolkit, o código-fonte do aplicativo e todas as dependências são pré-empacotadas para você.
• Guia passo a passo: permite configurar seu ambiente de desenvolvimento e criar um aplicativo do Teams desde o início.

GitHub Codespaces

Antes de criar seu codespace, verifique se você tem os seguintes pré-requisitos:

• Uma conta do GitHub para criar sua instância de codespace
• Uma conta do Microsoft 365 com permissão de carregamento de aplicativo personalizado
• Um locatário do Microsoft 365

Dica

O GitHub Codespaces oferece um plano gratuito com uma quantidade fixa de uso por mês. Se você precisar liberar mais espaço, vá para github.com/codespaces e exclua o codespace que você não precisa mais.

Para criar um bot de notificação interativo do Teams com os Codespaces do GitHub, siga estas etapas:

1. Selecione o botão a seguir para abrir os Codespaces do GitHub.

   

   Você pode ser solicitado a entrar na conta do GitHub se ainda não tiver entrado.

2. Selecione Create novo codespace.

   

   A página Configuração do codespace é exibida.

   

   O Teams Toolkit prepara um projeto de bot de notificação interativo para você e o abre no VS Code no navegador. O ícone kit de ferramentas do Teams é exibido na barra de atividades do VS Code.

3. Selecione Entrar no Microsoft 365 e entrar no Azure para entrar com sua conta do Microsoft 365.

   

   Observação

   Quando você cria seu aplicativo, o GitHub Codespaces o carrega para o cliente do Teams em uma nova guia. Se o navegador bloquear guias ou janelas pop-up, você precisará permitir pop-ups para que seu aplicativo seja aberto.

4. Selecione Visualizar seu Aplicativo do Teams (F5).

   

   O GitHub Codespaces cria seu aplicativo de bot de notificação interativo, o carrega no cliente do Teams e o abre em uma guia de navegador separada.

5. Depois que a caixa de diálogo do aplicativo for exibida, selecione Adicionar para instalar o bot de notificação interativo no Teams.

   

6. Abra um novo terminal no codespace e execute o seguinte comando para disparar um evento para enviar uma notificação interativa ao bot:

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

   Dica

   Em tempo real, os eventos são disparados por uma fonte externa, como uma API de terceiros que faz com que o bot de notificação envie uma notificação interativa ao usuário. Para emular um gatilho de evento, você pode enviar um evento manualmente por meio de comandos curl no terminal.

   O aplicativo bot de notificação envia uma notificação interativa como um Cartão Adaptável para seu cliente do Teams:

   

   Agora você criou com êxito um bot de notificação interativo e o carregou no cliente do Teams.

Guias passo a passo

Se você quiser aprender a iniciar um projeto com o Teams Toolkit desde o início, precisará configurar seu ambiente de desenvolvimento. Selecione o botão a seguir para começar a criar seu bot de notificação interativo.

Começar a criar um bot de notificação interativo

Se você quiser criar uma extensão de mensagem, acesse:

Criar extensão de mensagem

Se você quiser criar um aplicativo de guia básico, acesse:

Criar seu aplicativo de guia básico